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Preface 

This document describes standard Domain System software for the initial Beta 
version of Software Release (SR) 10.0. It includes an overview of new and 
changed functionality, a summary of bugs fixed since the last software release, 
a list of known errors and limitations, and a summary of changes to documen- 
tation. 

The normal software installation process places a version of these release 
notes in each node’s /install/doc/apllo directory. Release notes for optional 
Domain software are installed in a similar manner. If you are upgrading from 
a previous software release to SR 10.0, be sure to read Making the Transition 
to SRIO-Based Operating Systems (Order No. 011435) before installing SR10. 

Apollo Computer Inc. reserves the right to make changes in specifications and 
other information contained in this publication without prior notice, and the 
reader should, in all cases, consult Apollo Computer Inc. to determine 
whether any such changes have been made. 

How to Print the Release Notes 

You may print the online copy of this document. 

If your installation uses the System V Ip print daemon, use an Ip command 
similar to the following: 

Ip •Aprinter _name pathname 

where pathname is the pathname of the release notes, usually 
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/install/doc/apollo/os.vl0.0 notes. 

If your installation uses the Domain print system, use the following Aegis 
/com/prf command: 

prf pathname -pr printer_name -npag -point 10 

If your installation uses the BSD Ipd print daemon, use an Ipr command 
similar to the following: 

Ipr -P printer _name pathname 
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Chapter I: Changes to System Software 



Domain/OS Software Release 10 (SR10) is a general release of Domain® system 
software. It includes significant new functionality, performance enhancements, and bug 
fixes for previous releases. Additionally, at SR 10 the standard system software con- 
tains UNIX functionality that was previously supported by the separate Domain/IX™ 
product. SR 10 provides additional functionality, performance enhancements and bug 
fixes to the software that was supplied in previous releases of Domain/IX. 

The SR 10 release of the Domain operating system provides major benefits to Apollo’s 
customers in the form of an extended Aegis™ environment and enhanced support in 
the Domain kernel for UNIX functionality. It contains three separate operating 
environments that can run independently of each other and concurrently. The Aegis 
environment provides all the functionality of the Aegis operating system, including the 
SR10 extensions. The BSD and SvsV environments provide users with enhanced 4.3 
Berkeley Software Distribution and AT&T System V Release 3 UNIX environments, 
respectively . The SysV environment is compatible with the System V, Release 3 
SVTD (Base OS, Base Libraries, and Library Extensions) and includes support for Sys- 
tem V STREAMS. 

It is important to note that each of these environments runs without relying on the 
presence of any other. Neither of the UNIX environments, for example, requires a 
/com directory to run properly. 

Major changes and enhncements made to standard Domain system software since 
SR9.7, include the following: 

• Changes in node initialization and log-in procedures 

• Enhancements to system administration 

• Improvements in the file system 

• Changes in the process model 

• A new executable binary format 

• Enhancements to UNIX support 

• New and changed commands 

• TCP/IP is now standard in all environments 

This document describes changes made between SR9.7 and SR 10 and does not 
describe changes made in previous software releases. 

If you are upgrading existing SR9.7 or earlier-based systems to SR10, be sure to read 
Making the Transition to SR10 Operating System Releases (Order No. 011435) before 
installing new software. 
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This chapter briefly describes changes made to Domain/OS system software. This sec- 
tion is not intended to be a complete and detailed description of all changes at SR 10. 
Instead, it covers all areas of change and often refers you to Making the Transition to 
SR10 Operating System Releases or other manuals for detailed information. Addi- 
tionally, we have included a listings of all new and changed commands and calls in 
Appendix A of this document. 

1.1 New Software Installation Tools 

At SR 10 we provide a completely new set of software installation procedures that are 
both easier to use and more powerful than the previous installation scripts. For com- 
plete information on the new procedures, refer to Installing Software with Apollo's 
Release and Installation Tools. The major changes from a user perspective are: 

• An increase in speed of installation. The new installation tools are based on com- 
piled code rather than shell scripts. Thus, they are significantly faster than the old 
procedures. 

• A more flexible user interface. For a user wanting a standard system or product 
configuration, the new tools provide a complete system of defaults to eliminate 
time-consuming product or option selection. For a system administrator or user 
wishing to tailor a network or node environment to special site or personal 
requirements, the tools allow for a high degree of customization. 

• Integration of system software and layered software product installation. Formerly, 
installation of more than one product, or of system software and layered software 
products, had to be done on a serial basis; that is, all the objects in one software 
product had to be loaded before another product could be selected or configured. 
The new tools allow users to make all product selections, including selection of 
system software options and the choice of a default network or node environment, 
before any software is actually loaded to the target node. A user or system admin- 
istrator can configure the node or nodes to be installed during the day and run the 
installation itself during the night. 

• Simultaneous installation to multiple nodes. A system administrator can install 
SR10 software on multiple nodes simultaneously, if the nodes to be installed are 
running the Server Process Manager (SPM) program. 

In addition to providing the new Release and Installation functionality, Apollo provides 
an updated set of pre-SRIO installation scripts in the /install/sr9.7_compatibility direc- 
tory of the Authorized Area. Use the scripts in this directory to install SR9.7 based 
optional software products that are compatible with the SR 10 version of the 
Domain/OS operating system and are not being re-released with SR 10. The procedures 
are described in Chapter 5 of Installing Software with Apollo's Release and Installa- 
tion Tools. 

1.2 New Problem Reporting Procedures 

As of SR 10, we have implemented a new format for reporting software problems, cal- 
led the Apollo Product Report. At the same time, we have improved our ability to 
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track and respond to product reports. A new command, /usr/apollo/bin/mkapr, that 
generates an Apollo Probduct Report replaces the crucr command, which is now 
obsolete. The mkapr command is available in all Domain/OS environments. 

1.3 The Node and User Environment 

We’ve made significant Enhancements to the workstation environment that affect sys- 
tem administration and use. The following sections briefly describe these 
modiflcatons. 

1.3.1 Display Manager 

We have made the following changes to the Display Manager: 

• The DM now handles text lines of up to 1024 characters, including pathnames up 
to 1023 characters. 

• The DM can now handle 8-bit fonts; see "Font Support," below. 

• The DM now creates files of type unstruct, unstructured files without a Domain 
streams header, instead of type uasc unstructured ASCII with a streams header. 

• The DM no longer sets the execute bit on files that it creates. 

• The DM login prompt is now "login:". 

1.3.2 The /etc Directory 

All systems, even if they have only the Aegis environment, have an /etc directory. 

This directory contains many of the administrative commands and facilities that were 
located in the /com or /sys directories. The exact contents of the /etc directory 
depends on the installed environments. Any commands in /etc that were in the /com 
directory in previous releases are still available in that directory, usually through links. 

Because the /etc directory includes node-specific files such as /etc/ttys, each node, 
disked or diskless, has a ‘node_d at a/etc directory that contains files that are node- 
specific and the /etc directory entries are links to these files. 

1.3.3 The /usr/a polio Directory 

We now install a /usr directory in all environments and all systems, even if they have 
only the Aegis environment, now have a /usr/apollo directory. It contains certain 
common environment commands and Domain extensions to the UNIX environment. It 
also includes C include files for Domain system calls, as well as other added-value 
files. 

The /usr/apollo directory contains the following subdirectories: 

/usr/a pollo/bin This directory contains Domain commands that apply to all 

three environments or extend the UNIX environment. It 
includes commands that were previously in the /com 
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directory but are also applicable to the UNIX environments, 
new commands that apply to all three environments, and 
commands that are specific to UNIX under Domain/OS. 
While commands that were in the /com directory in pre- 
vious releases are still available in that directory, usually 
through links. /Usr/apoilo/bin is now on the default search 
paths for all shells. 

/usr/apollo/lib This directory contains binaries and related files that UNIX 

users do not run directly. Examples include the cc compiler 
that the /bin/cc program calls. The ftn compiler is also in 
this category. 

/usr/apollo/include This directory contains Domain/OS system call C include 

files with function prototypes. Both /sys5.3/usr/include and 
/bsd4.3/usr/include contain directories, called a polio, that 
are links to this directory. Versions of the Aegis system 
call C insert files that do not have function prototypes are 
located in the /sys/ins directory for compatibility purposes. 

See Making the Transition to SR10 Operating System Releases for more information 
on the /usr/apollo directory and its effects on all three user environments. 

1.3.4 Key Definitions 

We have made several enhancements to the key definitions at SR 10; these are descri- 
bed in the following subsections. 

1.3.4. 1 Key Definition Files and Initialization 

At SR 10, we have changed the files in the /sys/dm directory from which the Display 
Manager (DM) automatically loads the key definitions at login. The exact files that 
are used depend on the specific keyboard and environment. For detailed information on 
key definition initialization, see the Using Your Environment and Managing System 
Software manuals for your environment(s). 

AT SR10 key definitions support 8-bit characters. To accommodate this change, new 
files are used to store the binary versions of the most recent key definitions. For more 
information on these changes and their effects, see Making the Transition to SR10 
Operating System Releases. 

1.3.4.2 Additional Key Definition Changes 

You can now define the SHIFT/key and CTRL/key combinations for the following 
keys for Model II (including international) keyboards: BACK SPACE (bs), ESC (esc), 
RETURN (cr), and DELETE (del). You can also define CTRL/key combinations for 
all left keypad, (11-lf), right keypad (rl-r6) and numeric keypad keys. You cannot 
define any of these key combinations for Model I (old-style low-profile) or earlier key- 
boards. 
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Several standard key definitions have been changed. These changes are described in 
detail in Making the Transition to SR 10 Operating System Releases. (Key definitions 
are still user-modifiable.) 

1. 3.4.3 Keyboard Support of 8-Bit Fonts 

At SR10 we provide support for the composition of 8-bit characters, that is, characters 
in an 8-bit font where the the topmost bit is set. You can compose 8-bit characters on 
all keyboards through user-setable compose and alt key functions. We also supply a 
new command, /usr/apollo/bin/kbm, that displays the current keyboard characteristics 
and sets the compose key and the multi-national long and short shift keys. 

1.3.5 Font Support 

The following changes have been made in font support at SR 10. 

1.3.6 8-bit Support 

SR 10 includes new support for 8-bit fonts, that is, fonts that provide up to 256 charac- 
ters. The following font sets are now supplied in 8-bit format and conform to the ISO 
8-bit character set commonly known as Latin- 1, which includes all the characters used 
in Western European languages. 

• Courier family 

• din_f7xll 

• f5x9 

• f7xl3 

• f7xl3.b 

• Helvetica family 

• Times family 

• Legend family 

• Std family 

The remaining standard fonts do not include 8 -bit characters and are still supplied in 
7-bit font format. 

Because users may wish to continue using the keyboard character encoding of the pre- 
SR10 national fonts, we continue to provide the 7-bit versions of these fonts. However, 
we also provide a set of tools in /usr/a polio/bin, such as french_to_iso, that convert 
files written with the 7-bit format national fonts into 8-bit ISO Latin- 1 format. (Note 
that these tools are SysV Bourne Shell scripts and therefore require SysV software to 
run.) 

The SysV Bourne and Kom shells and the Aegis shell provide 8-bit support, as does 
DPSS/Mail. The keyboard supports 8-bit character input, and we provide tools for 
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creating 8-bit fonts and for converting between 7-bit and 8-bit fonts. 

Other features of the new font support include: 

• Mono- and proportionally-spaced fonts 

• Font file field to specify bytes per character 

• Minimum and maximum character code field 

• Bounding box coordinates around character 

• Underlining specification 

Programs that "knew" about the old format of fonts, i.e., included the smdu.ins file in 
their program, will NOT automatically work at SR 10. 

For detailed information on using 7-bit and 8-bit fonts, see Making the Transition to 
SR10 Operating System Releases . See Chapter 3 of these notes for a detailed list of 
restrictions on 8-bit fonts. 

1.3.7 Font Height 

The fonts in the Courier, Times, and Helvetica families are slightly higher than they 
were at SR9.7. 

|i _ 

1.3.8 Initialization, Login, and Shell Startup 

The node initialization, login, and shell startup sequences and procedures have been 
revised. The initialization sequence is designed to be independent of the windowing 
system and conforms more closely to the UNIX startup mechanisms. Login and startup 
procedures have added flexibility. 

At SR 10, the init process runs as Process 1, instead of the DM. It executes the file 
‘node_data/etc/rc and invokes getty to initialize the serial lines and start the DM or 
SPM. Also, each node’s default environment and systype are set by a /etc/environ 
file, while a user_data/.envron file specifies each user’s default environment and sys- 
type. See the User’s guide for your environment. Making the Transition to SR10 
Operating System Releases , and the Managing System Software manuals for detailed 
information on the initialization, login, and shell startup procedures. 

1.3.9 Aegis Shell 

The following changes have been made to the Aegis shell: 

• The shell now runs user_data/sh/startup in the home directory for every interac- 
tive version of the shell that is run. 

• The shell now runs user_data/sh/login any time it is invoked from a login pro- 
gram such as /com/login, siologin, crp (without -me). More specifically (for pro- 
grammers) the shell can be made to run its login program by invoking it with 
argv[0] set to ’-sh\ 

• The shell now checks that any program or shell script it invokes has execute per- 
mission for the current user. 
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• Environment variables can be defined at shell startup time by using 
•Dvariable[=\a\ue]. This feature can be used to make startup scripts branch depen- 
ding on how they were invoked. 

• The shell now supports 8-bit character input and output. 

• The shell now supports the use of a CSR (command search rules) environment 
variable. If this variable exists it is expected to contain a list of blank-separated 
pathnames that are used to determine where to look for executable files. Changes 
to the search path via the csr command will change this variable and changes to 
the variable will be reflected in the command search rules reported by the csr com- 
mand. However, unlike the csr command, changes to the CSR variable will not be 
inherited by the parent of a shell script. 

• All internal shell commands now output their errors to errout. As a result, error 
messages from internal commands can be redirected. 

• Stdout and errout can now be merged into a single file via (> foo >? foo). 

• The shell will continue searching through it’s search rules until it finds an executa- 
ble file that matches the specified name. Thus if you have a shell script called Id 
earlier in your search path than /cotn/ld, and that shell script is not executable, the 
shell will execute /com/Id and will not give you an error. However if it cannot 
find a copy of Id anywhere else in your search path, then you will get an error 
about the lack of execute permissions. 

• The shell no longer prints a one line status after a fault or undefined global error. 
This information can be obtained by using the tb command. 

1.3.10 The Print Environment 

Changes to the print environment at SR 10 include enhancements to the prf command 
to provide queue and job control, a new interface for adding drivers to prsvr, and a 
print manager that allocates and coordinates print resources in a network. See the 
"Changes to Printer Suport" section of this chapter for more information. 

1.3.11 SIO Lines 

We now provide full UNIX tty support (getty and init) for remote login over SIO 
(Serial I/O) lines, as well as siomonit and siologin. 

UNIX SIO line software now fully supports all UNIX line protocol semantics. The 
Aegis SIO software continues to support the Aegis semantics. As a result, the /dev/siojc 
files and the corresponding /dev/ttvxc files refer to the same devices, except that the 
state of the DCD line is always ignored on open by /dev/sio* devices. For a detailed 
description of this change and its effects, see Making the Transition to SR10 Operating 
System Releases. 

1.3.12 Handling Devices and Mounting 

via /dev" Both SR 10 UNIX environments support handling devices in the /dev 
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directory and building special files with the mknod command. 

1.3.13 Project Lists 

Project lists (group sets) are fully supported at SR 10 and may be used in all environ- 
ments. At SR9.7, project list entries matched only ACL entries of the exact form 
% .project_name At SR 10, the project list check substitutes each project in the 
user’s project list into the Subject Identifier (SID) and compares each resulting SID in 
doing an ACL check. See Making the Transition to SR10 Operating System Releases 
for more details. 

1.3.14 Process Accounting 

We provide local process accounting with /etc/sa and /etc/accton in all environments. 
The on-line manual pages provide details. 

1.3.15 Log-In Accounting 

We provide facilities to log login events. By editing the 

4 node_data/etc/login_log.conf file you can select to log any combination of the fol- 
lowing types of logins: DM, window, SPM, and sio line. You can also specify the file 
that will contain the logged information. 

1.3.16 Backup and rwmt 

We’ve made changes to the rbak and wbak commands to support a mixed pre-SRIO 
and SR10 network. We’ve also added support to tar and cpio for archiving typed 
files. 

The wbak and rbak utilities have been enhanced to allow backup output to be written 
to a streams object and restore input to be read from a streams object. Streams objects 
include files, standard input, and standard output. An option has also been added to 
the rwmt utility to disable byte swapping when data is written to magnetic tape. These 
features provide additional flexibility in the wbak process, including the ability to use a 
disk file as an intermediate staging area for backup output. (The ’disable byte swap- 
ping* feature is needed when using rwmt to write wbak output from a disk file to 
magnetic tape.) 

Rbak will no longer restore protected subsystems or setuid objects unless the user has 
permissions to do so. 

1.3.17 Korn Shell 

We’ve added support for the Kom shell in both the BSD and SysV environments. 

1.3.18 DPSS Mail to UNIX mail/UUCP UNIX mail 

SR10 includes the ability to gateway from DPSS mail to UNIX mail and to UUCP. A 
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field in the person entries in the registry allow users to specify a mail address. The 
DPSS mail product provides a command, /com/edsd, that allows you to edit the entries 
in a directory of subscribers. 

The SR10 BSD and SysV environments support 4.3BSD mail and AT&T System V, 
Release 3 mail, respectively. Both forms of mail use the sendmail utility as a base. 

1.3.19 Documenters’ Workbench 

Both UNIX environments of SR10 Domain/OS support Documenters’ Workbench 
(DWB), including the ditroff utility. The Documented Workbench is now an 
optional product. UNIX text formatting tools such as troff are no longer part of base 
SR10 System V software; the BSD environment still includes all tools that are part of 
the Berkeley distribution. 

1.3.20 SPM 

At SR 10, you can configure a system so that the Server Processor Manager (SPM) 
prevents unauthorized users from creating processes on or logging into a node. To do 
so, create a k node_data/spm_control file that lists the authorized users. See Making 
the Transition to SR10 Operating System Releases or the Managing System Software 
manuals for more information on this subject. 

1.3.21 Integrated TCP/IP 

At SR 10, TCP/IP software is a part of the base operating system. One version opera- 
tes in all environments, and the previous layered product is now obsolete. See Making 
the Transition to SR 10 TCP/IP for details. 

1.3.22 HoneyDanBer UUCP 

A single version of UUCP, known as HoneyDanBer, operates in both UNIX environ- 
ments. It is a more robust implementation providing enhancements such as spool 
directory trees and better security and error handling. SR 10 UUCP communicates over 
communications lines with most versions of UUCP, including Apollo pre-SRIO ver- 
sions and other vendors’ HoneyDanBer and other UUCP implementations. We also 
supply a version of HoneyDanBer UUCP that runs on SR9.7 systems and will work 
correctly on a network with SR 10 UUCP. See Making the Transition to SR10 Opera- 
ting System Releases for more information on running UUCP on mixed SR10/SR9.7 
networks. 

1.3.23 netman and Diskless Nodes 

At SR10 the /sys/net/netman program automatically executes the commands in the 
shell script /sys/net/netman.rc when a remote node attempts to boot diskless. This 
script creates and initializes the resources that are required to support the remote node, 
/sys/net/netman.rc is actually a link to either /svs/net/netman.com_sh or 
/sys/net/netman.bin_sh, depending upon the default node environment specified during 
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installation. 

We no longer supply the /install/create_partner script that was included in previous 
releases, however, the diskless list mechanism is still in effect. 

1.3.24 Changes in Domain Internet Support 

The maximum number of hops allowed in a Domain internet has been increased to six- 
teen provided that every network in the internet meets minimum network throughput 
performance guidelines. The minimum transmission rate over any single link must be 
at least one megabit per second with a maximum end-to-end delay of 100 ms. Refer to 
Planning Domain Networks and Internets for descriptions of the internet configurations 
and equipment that you can use to ensure adequate internet performance. 

When you install SR 10 on Domain internet routers, you must reassign network num- 
bers to the router’s principal and alternate networks. Refer to Managing Domain/OS 
and Domain Routing in an Internet for procedures that describe how to assign network 
numbers. 

1.3.25 OS Name and the MD 

The Operating System is now called Domain/OS, not Aegis. As a result, the OS file 
in the /sau/t directories has been changed to domain_os (with an underscore replacing 
the slash in the name). You can now start the operating system from the mnemonic 
debugger (MD) by using the following command: 

EX DOMAIN.OS 

1.3.26 Libraries in /lib 

We have changed the way in which libraries in the /lib directory are loaded. The 
/etc/sys.conf file now allows you to specify whether libraries must be loaded into glo- 
bal space or can be loaded into user space, whether the global libraries should be 
loaded on system initialization or when first needed at runtime, and whether the library 
is optional (that is, whether the system should initialize successfully if the library is 
not found). 

The following libraries in the /lib directory are obsolete at SR10: /lib/tblib, 
/lib/unixlib. 

The following libraries are new at SR 10: 

The libc and clib libraries now contain the data and entry points that were 
previously in the clib and unixlib libraries. 

The registry library; it is required on each system by the new distributed 
registry. 

The C preprocessor library; this is not a global library, but a link to 
/usr/lib/cpp. 
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dblib The debugging library; this is used by the traceback command and for 
cross-process debugging. 

We also supply four libraries in the /sr9.7_compatibility/sr9.7_executables/Iib direc- 
tory that should be should be installed on SR9.7 systems in a network with SR 10 sys- 
tems. The kg_.lib, loader_.libfR, and name_.lib libraries enable programs that 
reference SR10 entry points to run on the SR9.7 nodes. They contain interludes that 
convert SR10 entry points into SR9.7 entry points. The prflib library should replace 
the standard SR9.7 prflib. 

1.3.27 SysV terminfo Files 

We have made a change to save disk space at SR10. We have created the directory 
/usr/lib/terminfo.local that contains a set of terminfo files that are most commonly 
used. When sys5.3 curses looks for a terminfo file, it first checks to see if the file is 
under the new directory. If so, it uses that file. If not, it goes on to use the original 
/usr/lib/terminfo directory. Warnings or errors are never generated about missing files 
in terminfo.local (terminfo.local is about 78 blocks). You can install terminfo.local, 
terminfo or both locally or as links to a centralized directory. 

1.3.28 nsjielper 

At SR 10, ns_helper cannot run on diskless nodes. Additionally, the ns_helper’s data- 
base files have been moved from their SR9.7 location in the directory tree. Making 
the Transition to SR10 Operating System Releases describes procedures for converting 
an SR9.7 ns_helper to SR10. 

1.3.29 /usr/new Directory 

The /usr/new directory contains unsupported miscellaneous tools and commands from 
the Berkeley 4.3BSD distribution. You can optionally install /usr/new when you install 
either the BSD or SysV environment. It is then put in a single directory under / usr (so 
that it’s pathname does not include a systype). 

1.3.30 k node_data 

The *node_data directory has been rearranged to put more files into subdirectories. 
New subdirectories include svstemjogs for logging and dump files, svstmp for sys- 
tem temporary files, etc for node-specific \tc objects. 

1.4 The File System and Naming 

The operating system contains both a new file system and a newer, more robust direc- 
tory structure. The kernel and libraries are completely case sensitive at SR 10. Com- 
ponent names in a pathname can be up to 255 characters long, and pathnames can be 
up to 1023 characters long. 
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SR10 software can interpret, but no longer create, UNIX symbolic links. All UNIX 
commands and system calls that manipulate symbolic links now perform equivalent 
operations on Aegis links. 

All directories at SR10 contain the following entries: 

(dot, the current directory) 

(dotdot, parent of the current directory) 

The usage of the characters ~ (tilde) and (backslash) at the start of pathnames has 
been changed. The ~ character (representing the HOME or naming directory) must 
now be separated from the next component in the pathname by a / character. You can 
no longer use \ for the parent directory; you must use 

1.5 The Protection Model and ACLs 

Protection of file system objects is now based on both UNIX protections and the 
Access Control List (ACL). SR 10 ACLs have a simplified set of access rights 
(pwrxk), including a new right (k - keep) that allows you to specify an object as not 
deletable or renamable, regardless of the permissions associated with the containing 
directory. Each object has a set of required permissions that are stored in such a way 
as to increase performance. You can add finer degrees of protection to an object with 
extended ACLs, which are essentially like pre-SRIO ACLs. 

The SR 10 protection model integrates ACLs and the UNIX protections (modes) more 
tightly than at previous releases. If you do not use any of the ACL extension features, 
protection in the two Domain/OS UNIX environments works exactly as you would 
expect it to work in a UNIX environment, down to the differences in protection inheri- 
tance between 4.3BSD and SysV. 

Pre-encoded or "canned" ACLs, including the %. backup. % acl, are no longer required. 
Also, the ACL inheritance mechanism has been expanded to allow you to specify 
UNIX permission inheritance via the initial file and directory ACLs. 

See Making the Transition to SR10 Operating System Releases for more information 
on the changes to the protection model and its implications, including its implications 
for backup and for access on a mixed SR9.7 and SR 10 network. 

1.5.1 Other Protection Mechanisms 

We’ve added a command, /etc/I protect that allows a node user to protect a node from 
access by a remote process running as root. We have added a file 
fc node_data/node_owners that enables you to specify which users can run Iprotect on 
the node and sigp any process on the node. Also, a ‘node_data/spm_control file can 
control the users gaining access to the node via the SPM. See Making the Transition to 
SR10 Operating System Releases for more information on these facilities. 

1.6 The Registry 

TM 

The SR 10 registry is based on Apollo’s Network Computing System (NCS); it 
1-12 



Software Changes 




Software Release 10.0 — Beta2 Version: 4/19/88 



comprises a server and a database of naming and account information. Since the 
registry can be replicated, it scales well to all sizes of networks. In addition, the regis- 
try data is highly available, and easily propagated, which is not always the case in an 
environment that uses a single user account information file. 

You can decentralize administration of the registry, if you wish, by changing the own- 
ership of organizations in the registry database. Registry information is manipulated 
by the edrgy command. Access to most of the functionality of the edrgy tool is limi- 
ted to the owner of the entries, typically system administrators, but users can change 
certain fields of their own entries. 

Because the registry uses NCS, each registry site must also ran the local location 
broker daemon, llbd. The standard startup script templates include lines that will 
automatically start this process. Also, at least one node on each network must ran the 
global location broker, glbd. 

At SR 10, we use the UNIX password encryption algorithm to encrypt passwords 
stored in the registry. For compatibility, passwords are also maintained in SR9.7 
encryption. 

Apollo’s implementation of the two UNIX environments includes the /etc/passwd and 
/etc/group files, which contain user account and group information, respectively. 

These are typed read-only files and are generated by the registry daemon automati- 
cally. 

1.7 The Programming Environment 

Several changes have been made in the programming environment at SR 10. These 
include the following: 

• Support for case-sensitive naming 

• Single program-per-process invocation model 

• COFF object module format 

• Support for long names 

• New ACL interface semantics 

• Changes in standard IOS stream numbering 

• Data alignment support in compilers 

• Changes in symbolic link support 

• Changes in the malloc and rws_$alloc algorithm 

• A new debugger 

The following subsections summarize these changes. See Chapter 4 of Making the 
Transition to SR10 Operating System Releases for detailed information on changes to 
the programming environment. 
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1.7.1 Case Sensitivity 

At SR 10, the kernel and libraries are case sensitive with respect to pathnames and 
symbol names. Programs that depend on case-insensitive behavior do not work at 
SR10. However, we have provided a downcase mode (controlled by the DOWNCASE 
environment variable) as a temporary compatibility measure. Support for DOWN- 
CASE will be removed at the next major release. 

1.7.2 Process Invocation and Absolute Code 

At SR 10, the default process invocation model has changed to one in which a new 
program is always invoked in a new process. This change permits more general sup- 
port for non-relocatable (absolute) code. While Apollo will continue to support reloca- 
table code and in-process program invocation, we have converted all Apollo software 
to work when invoked in a separate process. 

As part of this change, Domain C, Pascal, and FORTRAN compilers now produce 
absolute code by default, which will make most programs run faster. You can still 
produce position-independent (relocatable) code by specifying the -pic option on the 
command line. 

Also, at SR 10 UNIX shells do not support in-process invocation of commands or pro- 
grams; that is, they do not support the inprocess variable. The Aegis shell still supports 
in-process invocation, however, when the INPROCESS variable is defined. 

1.7.3 Object File Format 

SR 10 compilers generate a new object format which is an extended version of the 
AT&T Common Object File Format (COFF) standard. COFF object modules are not 
compatible with the "obj" format object modules produced by previous releases. To 
make full use of SR 10 program development tools, you should recompile all source 
files. Programs that have knowledge of pre-SRIO object module format must be 
changed. It is not possible to bind old (obj) and new (COFF) modules into a single 
object. However, we provide an obj-to-COFF conversion tool which is documented in 
Making the Transition to SR10 Operating System Releases. 

1.7.4 Long Names 

At SR 10, component names can be up to 255 characters long, and pathnames can be 
up to 1023 characters long. Previous limits were 32 characters for a leaf (component) 
name and 256 characters for a pathname. New name_$ system calls have been added 
to support long names. 

1.7.5 Data Alignment 

Programs that make use of data structures in which data is naturally aligned, (that is, 
where the address boundary of each object is a multiple of its length) run faster than 
programs with data that is not naturally aligned. We, therefore, urge programmers to 
use naturally aligned data structures in their programs. We have added new facilities 
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to the Pascal and C compilers to support natural alignment. 

1.7.6 Changes in Standard Streams 

At SR 10, both Aegis and UNIX COFF programs are invoked with three file descrip- 
tors, or streams, open, and the Aegis errin stream is no longer supported. Obj objects 
(pie-SRlO format) are still invoked with four streams. The rules for various situations 
at SR 10 are in Making the Transition to SR10 Operating System Releases. 

1.7.7 Directories 

The Domain/OS naming calls that are new at SR 10 and the UNIX directory calls 
return the . (dot, this directory) and .. (dotdot, parent of this directory) entries. 

1.7.8 System V STREAMS and TLI 

The SysV programming environment supports System V streams, part of the Network 
Extensions to System V Release 3. It provides a framework for developing communi- 
cation services. SysV also supports the Transport Layer Interface (TLI), which provi- 
des a protocol-independent interface to the transport layer of communication services 
developed with STREAMS. See Getting Started with SysV STREAMS , Programming 
with SysV STREAMS, and Programming with the SysV Transport Layer Interface for 
detailed information on System V STREAMS and TLI. 

1.7.9 Std_$call Convention 

The std_$call calling convention is considered obsolete at SR 10. We retain the Aegis 
system call insert files with std $call in /sys/ins/?*.ins.c, but we do not commit to 
maintaining these files in future releases. We now use the function prototyping feature 
of ANSI C to provide the same capability with cleaner syntax. Released Aegis system 
calls have new insert files written in C which contain ANSI function prototypes. The 
new C insert files reside in /usr/include/apo!lo/?*.h for better integration with the rest 
of the C library. 

1.7.10 Opening and Accessing Files that Lack Type Managers 

The Domain IOS streams facility has been modified so that it is possible to open files 
that do not have type managers. In the past, attempts to open such files through 
streams (ios_$open, Pascal/FTN open, UNIX open(2), etc.) always failed. Since 
UNIX programs do I/O to files only via streams, they could not access such files. 

At SR10, the IOS streams facility will open a file of a type that has no manager if the 
type is listable at the node that is opening the file, that is, if the Ity command will 
display that type. (You can make a type listable by using the crty command.) The 
streams facility will then treat the file exactly as if it were of type "unstruct", an 
unstructured file without a streams header. 
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1.7.1 1 mallocO and rws_$alloc 

The calls mallocO and rws_$aHoc now attempt to reserve the specified amount of 
backing store on disk. If the requested amount of disk space isn’t available, then the 
calls fail. This behavior ensures that a program will not get a "disk full" fault when it 
touches data in the allocated area; disk storage is always reserved for allocated 
memory. As a result of these changes, increased disk space must be available to run 
programs that do large mallocs or space allocation. This space is made available for 
reallocation when the program makes the corresponding free or rws_$release call; it is 
released when the program terminates. 

We have also provided a module to help in debugging malloc calls. 
/usr/apollo/Iib/libmalloc.dbg is a library containing versions of malloc, free, realloc, 
and calloc that you can inlib if there is an apparent problem with any of these calls. 
This module is essentially the same version of malloc that’s supplied in the libc global 
library, but compiled with the full optional checking and statistics gathering turned on. 
It does fairly stringent checking on each call to malloc or free; if it discovers storage 
corruption, it prints a message about what it discovered on stderr, and calls abort() to 
produce a proc_dump. 

1.7.12 New Compiler Features 

In addition to generating COFF files and absolute code, the language compilers at 
SR10 also provide many new and modified options for improved efficiency and UNIX 
compatibility. 

The FORTRAN, C, and Pascal compilers support 8-bit characters in comments and 
strings. However, they do not support characters with the uppermost bit set in identifier 
names, and flag attempts to use such characters as errors; therefore, identifiers must be 
in 7-bit ASCII. 

Domain C supports function prototypes as defined in the proposed ANSI standard and 
in the C++ language. Domain C also allows you to replace certain UNIX mathlib calls 
with inline code by including the <builtins.h> header file. These built in routines pro- 
vide faster execution times than the corresponding library calls. 

Compiler changes for SR 10 are fully detailed in the SR 10 Domain Language 
Reference manuals. An overview of the changes is also available in the release notes 
for these products. 

1.7.13 A New Debugger 

SR10 replaces DEBUG with a new debugger, Domain/DDE, which can debug both obj 
and COFF format objects. Domain/DDE provides many new features such as a 
menu-driven interface, language-sensitive expression evaluation, multiprocess debug- 
ging, and cross-node debugging. 

The new debugger also has macros that simulate the old DEBUG and dbx The 
macros to simulate Domain/Debug syntax syntax; these macros are located in 
/sys/debug/old_debug_macros and /sys/debugdbx_macros, respectively. 
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DDE cannot debug programs built before SR9.5. For full details see the Domain Dis- 
tributed Debugging Environment (Domain/DDE) Reference. 

1.7.14 The Bind Utility 

We’ve made the following changes to the bind utility for SR 10: 

• The binder now handles only those objects produced by SR 10 compilers, SR 10 
linkers (/com/bind or /bin/ld), or SR10 archivers (com/Blbr or /bin/ar). The bin- 
der will not handle any object files compiled prior to SR 10. 

• The bind utility supports both a -runtype option to control the UNIX run-time sys- 
tem call semantics and a -systype option to control pathname semantics. See the 
Domain Binder and Librarian Reference for details on the options. 

• At SR 10, you must use the -mergebss bind option whenever you have compiled a 
C program with /bin/cc or by using /com/cc with the -bss option. When you bind 
with the -mergebss option, you cannot run the output file through the binder again. 

• The binder can now mark object modules to be run with a non-default stack size. 
(The default is 256k). 

1.7.15 The Ibr Utility 

We’ve made the following changes to the librarian utility, Ibr, for SR10: 

• The Ibr utility handles only those objects generated by SR 10 compilers, SR 10 link- 
ers (/com/bindd or 1/bin/d) or SR10 archivers (/com/lbr or /bin/ar). .LI The Ibr 
utility now generates library files in UNIX archive (ar) file format. 

• The format of -list output is now the same as ar -tv format. 

1.7.16 The apoilo_$std.h File 

The UNIX include file /usr/incIude/apollo_$std.h is currently supported for use by the 
/com/cc compiler. In the UNIX environments, the C preprocessor automatically 
defines the constants specified in this file. The /com/cc compiler automatically includes 
the file. However the /com/cc compiler does not issue any warning if the file is mis- 
sing. Apollo does not commit to support this file in the next major release. Future 
releases of /com/cc will not automatically include this file, and we will not ship the file 
as part of the software distribution. 

1.8 Printer Support 

With the release of SR 10, the print architecture has been updated. Two new com- 
ponents, prmgr (print manager) and prelOq (pre-SRIO daemon), have been added to 
prf and prsvr. The print manager coordinates user print requests generated via prf 
with printer resources provided by prsvr. The pre-SRIO daemon, prelOq, permits 
printing pre-SRIO jobs in an SR 10 environment. This can occur when a network is 
operating in a mixed environment (some nodes at SR 10, some at pre-SRIO levels). The 



Software Changes 



1-17 




Software Release 10.0 -- Beta2 Version: 4/19/88 



following sections describe some of the changes in printer support. For detailed infor- 
mation on configuring and running printer facilities, see the Managing System Software 
manual for your environment. 

1.8.1 The Print Manager 

The print manager controls one or more print servers. With SR10, it is no longer pos- 
sible to queue jobs to a non-existent printer. The print manager checks each job to 
ensure it has a printer with the specified name. If none is found, it rejects the job. 

Print servers are ’’bound" to a print manager by a new option in the print server 
configuration file called "prmgr_site", which identifies the print manager by the 
manager’s logical name. The print manager logical name can be the same as the spool- 
ing node name. 

1.8.2 The Print Server 

Several new directives have been added to prsvr, and several old ones obsoleted. The 
following options are now obsolete: 

cpi Replaced by the point option 

pageno_column Use the page__headers, header_string, and footer_string options 

page_length Use the paper_length option 

page_width Use the paper_width option 

plot_mode Ignored by prsvr 

print_length Use the paper_length option 

print_width Use the paper_width option 

sio_line Use the io_device_name option 

When the print server starts, it prints a startup page indicating the default settings for a 
print job. If the print server configuration file contains obsolete directives, they are 
listed on the startup page. Modify the configuration file to eliminate obsolete com- 
ponents and restart the print server. See the Managing System Software manual for 
your environment for detailed information on the print server and its configuration file 
options. The help file /sys/help/prsvr/conttg.hlp also documents all configuration 
options. 

1.8.3 The prf Command 

The prf command includes the following new options: -prelO, -dialog, -check, 
-list_printers, -iist_sites, and -sig_printer. The -prelO and -check options together 
determine both whether the job is queued to an SR9.7 or SR 10 print server and the 
errors that are reported. If you specify -prelO, the print request will only be queued to 
an SR9.X server and you will not get an error message if the requested printer does 
not exist. If you specify -check, the print request will only be queued to an SR 10 
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server and you will get an error message if the requested printer does not exist. If you 
use neither switch, the job is queued to any available server, and you will not get an 
error message if the requested printer does not exist. 

1.8.4 The prelOq Daemon 

The prelOq daemon handles queueing of requests from SR9.X nodes to an SR 10 print 
server. The system administrator starts this process to monitor the SR9.X print queue. 
See chapter 3 of Printing in the Aegis Environment or the anaging System Software 
manual for your environment for details. 

1.9 Changes to TCP/IP Support 

At SR 10, our TCP/IP product is completely restructured. Previously, we offered two 
TCP/IP products. Domain TCP/IP for the Aegis environment and Domain/IX 4.2BSD 
TCP/IP for the Domain/IX environment. While these products provided the same 
basic capabilities, they differed in their configuration processes and application pro- 
grams. The products also differed because Domain TCP/IP was an optional software 
package for Aegis users, and Domain/IX 4.2BSD TCP/IP was bundled with 
Domain/IX operating system software. 

At SR 10, TCP/IP has a single implementation that follows the 4.3BSD UNIX model 
and works in all three environments: BSD, Aegis, and SysV. All TCP/IP software, 
including the 4.3BSD network extension, is included in the standard software distribu- 
tion, and the TCP/IP layered products are no longer supported under SR 10. (However, 
you can operate a mixed network of SR10 and pre-SR 10 TCP/IP hosts.) Pre-SRIO 
TCP/IP enhancements have been carried forward to preserve functionality. Other 
upward-compatible enhancements have been introduced to improve TCP/IP perfor- 
mance and administration. In addition, SR10 TCP/IP incorporates numerous bug fixes. 

At SR 10, programs and utilities associated with the Domain TCP/IP product have been 
replaced with their 4.3BSD counterparts. For Domain TCP/IP users, this means fol- 
lowing new TCP/IP configuration procedures and learning a slightly different user 
interface for TCP/IP application programs. For Domain/IX users, the transition is to 
the 4.3BSD model. 

TCP/IP internet administration at SR 10 also follows the 4.3BSD UNIX model. All 
administrative files reside in the /etc directory. The new 4.3BSD name daemon, 
named, greatly simplifies host-name/address resolution in large TCP/IP internets. A 
new Apollo option to the rwho daemon allows a master node to track all users in the 
local network or in an entire Domain internet. 

Host administration is based on the /etc/rc startup file. See Making the Transition to 
SR10 TCP IIP for details about the Domain/OS TCP/IP implementation. See 
Configuring and Managing TCP HP for administrative information; in particular, see 
Procedure 3-2, "Configuraing a TCP/IP Host or Gateway" for the specific configuration 
steps that are required before you can use TCP/IP. 

For information about using TCP/IP application programs, see Using TCP/IP Network 
Applications. Further documentation for TCP/IP programs and utilities can be found 
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in the BSD Programmer’s Reference and Managing System Software for BSD. 

All Domain network controllers support TCP/IP host and gateway operations. The 
device drivers for these controllers are resident in standard software. The 
EtheiController-MB , a special-purpose controller that operates through a GPIO inter- 
face, also supports TCP/IP host and gateway operations. The driver for the 
EtheiController-MB is available in the COM_ECMB optional software package. 

At SR 10, there is one programming interface to TCP/IP, the 4.3BSD socket interface, 
which now supports raw sockets. Although the socket interface is BSD functionality, 
it can be used in all three environments. A new manual which describes using the 
socket interface. Programming with 4. 3 BSD Socket Calls , will be available after the 
SR 10 release. For the present, consult the Domain Programming Tools Reference 
(11010-A00) and the BSD Programmer’ s Reference for information about socket calls. 

Berkeley has changed the BSD TCP/IP socket interface between 4.2BSD and 4.3BSD. 
(The data structure returned by gethost was changed.) SR10 TCP/IP conforms to the 
4.3BSD standard. Therefore, although an application that was built using 4.2BSD 
should work under 4.3BSD, it cannot be changed and recompiled using SR10 software 
without first modifying it to conform to the new interface. 

Making the transition to SR10 TCP/IP is a simple exercise for Domain/IX 4.2BSD 
TCP/IP users, but it is more complex for Domain TCP/IP users. Making the Transi- 
tion to SR10 TCP/IP provides information to aid users of Domain TCP/IP in conver- 
ting to the BSD model. These tools include program- and file-mapping tables that 
compare the SR10 and pre-SRIO TCP/IP products. Configuring and Managing TCP/IP 
contains detailed information about setting up TCP/IP hosts and internets. 

1.10 GPIO Support 

The following general changes occur in Domain GPIO with SR 10: 

• All ddfs (device descriptor files) must be rebuilt with the SR 10 version of the 
crddf command. 

• All ddfs are now character-special devices. 

• Global entry points are now case sensitive for case-sensitive languages such as C. 

• A new GPIO procedure has been added to support the acquisition of devices in a 
streams type manager. The procedure is pbu_$acquire_stream. 

The following GPIO commands and procedures have been changed or added with 
SR10: 

• aqdev (changed) 

• crddf (changed) 

• pbu_$acquire (changed) 

• pbu_$acquire_stream (added) 
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Making the Transition to SR10 Operating System Releases describes in detail the 
effects of these changes on GPIO components that are provided as part of standard 
system software, and the GPIO release notes detail all changes in the GPIO product. 

1.11 Network Computing Support 

While most Network Computing functionality supported by SR 10 is not new, the 
Network Computing Kernel (NCK) software is now required for the operation of both 
the registry and the new hardcopy system; therefore, we are repeating the information 
that was included in the SR9.7 Release Notes. 

The Network Computing Kernel is a component of the Network Computing System 
(NCS), a set of tools for heterogeneous distributed computing. Applications can use 
NCS to distribute both data and program execution among different types of processors 
and across one or more heterogeneous networks. NCS tools run on Domain worksta- 
tions and are designed to be portable to other processors. 

NCK provides the run-time support for distributed computing, including the run-time 
support for the registry and hardcopy servers. In addition to NCK, the Network Com- 
puting System includes the Network Interface Definition Language (NIDL) and com- 
piler, used to develop distributed applications. Unlike NCK, NIDL is an optional pro- 
duct and is therefore not included with SR10. Concurrent Programming Support (CPS) 
is support for multitasking in a single process. 

For more information regarding these products, refer to the Network Computing System 
Reference and the Concurrent Programming Support Reference. 

1.12 GSR 

GSR is being rereleased at SR10 with a new stroke font in /sys/gsr/gsr.stroke_font. 
The SR9.7 font will not work on SR10. Likewise, the SR10 font will not work on 
SR9.7. 
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Chapter 2: Software and Hardware Compatibility 



This chapter describes the compatibility between SR10 software and previously 
released software. It lists the layered software product releases that can successfully 
run on SR 10 and SR9.7 nodes in a network that includes workstations running both 
base releases. It also lists certain hardware limitations. Making the Transition to SR10 
Operating System Releases provides more detailed compatibility information. 

2.1 Hardware Configuration Considerations 

The following Hardware Configuration restrictions and recommendations apply to 
Domain/OS SR 10. 

• SR10 Does not support DN100, DN400, DN420, or DN600 systems. These 
workstations will work under SR9.X releases, including SR9.7. Apollo will con- 
tinue to support these machines under SR9.X releases at least until the next major 
release of the operating system (some time in 1989). SR 10 will work on all other 
node types, including the DN460 and DN660 systems. 

• SR10 requires a minimum memory size of two megabytes. We recommend that 
systems have a memory size of three or four megabytes for increased performance. 

• Because of a change in the storage allocation algorithm described in Chapter 2, 
many SR10 applications will not run correctly on a system with a nearly full disk. 
Attempts to run with too little free disk space will result in disk full errors. As a 
general rule the operating system requires at least 500K bytes per user process on 
all systems except the Series 10000. 

• Because of the requirement for free space and an increase in system software size, 
stand alone workstations with 50MB or less of disk space may require additional 
storage, depending on your computing needs. 

Apollo offers many upgrades and add-on offerings to provide additional memory and 
storage space. Additionally, we offer "020" cpu and memory upgrades for 3XX and 
5XX systems. We have significantly reduced the price of many of these upgrades. See 
your sales representative for information on these upgrade programs. 

2.2 Object Module Compatibility 

The object module format has been standardized on Common Object File Format 
(COFF) at SR 10. SR9.2 object modules that execute successfully on systems running 
SR9.5 and that were not compiled for SR8 (i.e., not compiled for System III and 
4.1BSD, or AUX) will run on SR10, subject to the same compatibility restrictions that 
affect SR9.5 object modules. 

We no longer support AT&T System III or Berkeley 4.1BSD call semantics. Object 
modules that were stamped with the sys3 or bsd4.i systype cannot run on SR 10. This 
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restriction includes C programs which were compiled and bound by pre-SRIO tools 
under Aegis with no systype specification (which also received a systype stamp of 
sys3.) They must be ported to the new call semantics and rebuilt with a currently sup- 
ported systype. 

Object modules compiled under SR9.5 through SR9.7 will execute on systems that run 
SR10, subject to the compatibility restrictions discussed in detail in Making the Transi- 
tion to SR10 Operating System Releases. 

SR10, does not support compiling a module targeted to run on pre-SR9.5 systems (i.e., 
you can’t produce or debug SR9.2 object modules on SR 10). However, the SR10 
FORTRAN, Pascal, and C language releases do include versions of the SR9.7 com- 
pilers that contain bug fixes; you can use these compilers on SR10 (or SR9.7) systems 
to generate code that will run on SR9.7 systems. Also, you can copy existing SR9.7 
development tools onto an SR 10 system and use them to develop applications targeted 
for systems with software releases from SR9.5 through SR9.7. The SR10 debugger can 
work with SR9.5 and later object modules. 

2.3 Network Compatibility 

Nodes running SR 10 can communicate with and access files on nodes running all pre- 
vious releases. Nodes running SR9.7 can communicate with and access files on nodes 
running all previous releases and nodes running SR 10. There can be some loss of 
information in the transformation of Access Control Lists (ACLs) between SR10 and 
pre-SRIO nodes, but all changes that occur result in more restrictive access rights 
rather than less restrictive. 

Nodes running pre-SR9.7 software releases cannot access files on SR 10 nodes but they 
can communicate with SR10 nodes for informational purposes. Thus, sitting at an 
SR9.5 node, you cannot access files on an SR 10 node; you can, however, run some 
network commands and such non-file operations as bldt and pst. 

We recommend that if youmust mn pre-SRIO software on a network with SR 10 sys- 
tems, you should update all pre-SRIO systems to SR9.7. 

2.4 Media Compatibility 

Changes to on-disk structures at SR 10 require that you reformat a node’s disk with the 
invol utility before you install SR 10. (We’ve made changes to invol, so you must use 
the SR10 version of this command.) 

All disk volumes (floppy and removable hard disks) generated on systems running SR5 
or later releases can be mounted on an SR10 system. No volume that has been initial- 
ized as an SR 10 file system can be mounted on any pre-SRIO system. However, the 
SR10 invol program has an option that will generate pre-SRIO formatted volumes. 

You cannot use a pre-SRIO node as a source node for SR10 installations, and you can- 
not mn SR10 installation software on a pre-SRIO node. 
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2.5 Layered Product Versions Compatible with SR 10 

The following tables list layered product versions that can be used on SR9.7 and SR 10 
nodes in a network that includes both releases. The layered product version numbers 
reflect the latest versions that work with the corresponding operating system, not the 
version that was shipped with that release. Note that products that will be available 
after SR 10 are shown in parentheses. Later versions of optional products are also 
compatible, unless otherwise stated in those products’ release notes. 

The table is not intended to help you determine which layered products are available 
for purchase. For specific information about purchasing layered products, see your 
local Sales Representative. 



Comparison of Layered Product Versions 


Product 


SR9.7 Version 


SR 10 Version 


Comment 


A-ADD-ETH 


? 


Obsolete 


In base OS 


ALIS 


1.10L 


Not available 


Not available at SR 10 FCS 


Domain/Access 


2.0 


3.0 


Older versions do not work 
on SR10 


Domain/Ada 


1 .0/1.1 


1.5 


Post SR 10 FCS release; an 
interim version is available 


Domain Assembler 


Not available 


1.0 


Newly supported at SR 10 


Domain/C (CC) 


4.89 


(SR10) 


SR 10 release includes a 
bug fix version of the 9.7 
compiler that runs on SR 10 
nodes and generates code 
for pre-SRIO systems 


Domain C++ 


1.2 


1.2 


Post-SRIO FCS 


Domain/CORE 


9.5 


9.5 




Domain/CommonLIS P 


2.10 


2.2 


Post-SRIO release; an 
interim version is available 


D3M 


5.5 


6.0 


Version 5.5 must run on 
9.7 nodes in a mixed 
network of SR9.7 and 
SR 10 systems 


Domain/Dialogue 


2.0 


2.01 


Older versions do not work 
on SR 10 
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Comparison of Layered Product Versions ! 


Product 


SR9.7 Version 


SR10 Version 


Comment 


Domain/Delphi 


1.0 


1.0 


SR10 books are unavalable 
at Beta; see "Restrictions" 
section of Chapter 3 for 
loader restriction 


Domain FORTRAN 


9.66 


10.00 


SR 10 release includes a 
bug fix version of the 9.7 
compiler that runs on SR 10 
nodes and generates code 
for pre-SRIO systems 


Domain/IX 


9.5 


Obsolete 


In base OS 




2.2 


Obsolete 


In base OS 


Domain/LU6.2 


1.0 


1.1 


Older versions do not work 
on SR 10 


Domain/P AK 


2.1 


3.0 


Older versions do not work 
on SR 10 


Domian Pascal 


7.38 


(SR10) 


SR10 release includes a 
bug fix version of the 9.7 
compiler that runs on SR10 
nodes and generates code 
for pre-SRIO systems 


Domain/PCC 


2.1 


3.0 


Version 2.10 runs at SR10, 
except for diagnostic; Ver- 
sion 3.0 is post-SRlO FCS 


Domain/PCC_Remote 


1.1 


Obsolete 


Included in Domain/PCC 


Domain/PCE 


1.0 


3.0 


Version 1.0 runs at SR 10, 
except for diagnostic; Ver- 
sion 3.0 is post-SRIO FCS 


Domain/PCI- 1 


3.0 


4.0 


Post-SRlO FCS 


Domain/PCI - 
ETHERNET 


? 


4.0 


Post-SRIO FCS 


esssbesssbe™ 


1.0 


4.0 


Post-SRlO FCS 


Domain/SNA 3270 


2.0 


2.1 


Older versions do not work 
on SR 10 


Domain/SNA 3770 


l.l 


1.2 


Older versions do not work 
on SR10 


Domain X.25 


2.3 


2.3 
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Comparison of Layered Product Versions 


Product 


SR9.7 Version 


SR 10 Version 


Comment 


Domain 4014 


2.0 


2.1 


Older versions do not work 
on SR 10; At beta, the ver- 
sion 2.1 does not have 
release notes 


Domain 5080 


2.0/3.0 


3.0 


DOWNCASE must be set 
to true at SR10 


DPSS/Mail 


1.1 


2.0 


Older versions do not work 
on SR10 


DSEE 


3.2 


3.3 


Version 3.2 must run on 
9.7 nodes in a mixed 
network of SR9.7 and 
SR 10 systems 


Documenter’s 

Workbench 


Not Available 


2.0 


Newly supported at SR 10 


ECMB 


7.2 


7.2 




EtherB ridge 


1.4 


Obsolete 


In base OS 


EtheiController-AT 


2.0 


tbd 




2DGMR 


2.0 


2.1 


Version 2.0 requires 7-bit 
fonts; Version 2.0 supports 
8-bit fonts; an interim ver- 
sion of 2.1 is available 


3DGMR 


2.5 or 2.6 


2.6 




GKS 


1.0 


1.0 




GPIO 


9.6.1 


10.0 


Older versions do not work 
on SR 10 


GSR 


2.0 


2.1 


Only change between 2.0 
and 2.1 is in stroke font 
structure; Version 2.1 is 
required for using stroke 
fonts on SR 10 


Interleaf 


2.5.13 


unavailable at 
beta 


An interim version is 
available 


NFS 


1.0 


2.0 


Older versions do not work 
on SR10 


Network Interface 
Definition Langu- 
age 


1.0 (plus patch) 


1.0 (plus patch) 


See "Installation of Pre- 
SR10 Optional Products", 
below, for SR 10 installa- 
tion requirements 
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Comparison of’ Layered Product Versions 


Product 


SR9.7 Version 


SR 10 Version 


Comment 


Network License 
Server 


1.0 


1.0 




Open Dialogue 


1.0 


1.1 


Post-SRIO FCS Release 


PHIGS 


1.0 


1.0 




PostScript 


1.0 


unavailable at 
Beta 




PS PRINT 


? 


Obsolete 


In base OS 


RJE 


2.1 


2.2 


Unavailable at Beta 


SPE Board Driver 


1.2 


2.0 


Older versions do not work 
on SR 10 


TCP/BSD4.2 


3.0 


Obsolete 


In base OS 


TCP/IP 


3.0 


Obsolete 


In base OS 


TEK 4692 


1.01 


Obsolete 


In base OS 


TML++ 


1.0 


1.0 




TranScript 


Not available 


2.0 


Newly supported at SR 10 


Versatec 


2.1 


2.1 


See "Installation of Pre- 
SRIO Optional Products", 
below, for SR 10 installa- 
tion requirements 



2.6 SR9.7 Compatibility Items 

The SR10 release includes a directory, /sr9.7_compatibility, that contains a variety of 
files and tools required for compatibility between SR10 and SR9.7 systems. This 
directory is divided into two subdirectories, as follows: 

sr9.7_executables This directory contains programs which you should mn on 

SR9.7 systems that are connected to networks that have SR 10 
systems. In most cases, they should replace software that was 
shipped at SR9.7. These facilities include a version of Honey- 
DanBer UUCP that will work with SR 10 HoneyDanBer 
UUCP, software for printing in a mixed SR10/SR9.7 
environemt, NCS support, and a tool for converting between 
SR9.7 and SR 10 registries. It also provides libraries that allow 
you to run SR 10 compilers on SR9.7 nodes. 

compat_with_sr9.7 This directory contains sr9.7 software that enables an SR 10 

system to generate "obj" format object modules that will mn 
on pre-SRIO systems. These include versions of the librarian 
and various UNIX program development tools. 9.7-compatible 
compilers can also be put in this directory when you install 
SR10 C, Pascal, and FORTRAN. 
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This directory also contains tools that run on SR10 nodes to 
provide compatibility with objects generated on SR9.7 sys- 
tems. These tools include the cvtname command that con- 
verts between SR9.7 and SR 10 case representation. (At beta, 
cvtname is in the /com directory). 

Note that the SR10 release does not include SR9.7 insert files or fonts. If you wish to 
use these on an SR 10 system, you must obtain the required tools from an existing 
SR9.7 system. 

Making the Transition to SR10 Operating System Releases describes all SR9.7 compa- 
tibility items in detail and discusses the considerations for generating pre-SRIO execu- 
table software on SR 10 systems. 

2.7 Optional Products Released in Multiple Versions 

The Domain Software Engineering Environment (DSEE) and D3M optional products 
are being released at the same time as SR10 in two versions, one that runs on SR10 
systems and one that runs on SR9.7 systems. In these cases, the versions of the 
optional product that were available before the release of SR 10 will not work properly 
in an environment that also includes SR 10 nodes, and you must now install the new 
SR9.7-compatible version on all SR9.7 nodes. ' 

The installation software will only install the correct version of these products. That 
is, it will produce an error message if you attempt to install the SR 10-compatible ver- 
sion on an SR9.7 system or if you attempt to install the SR9.7-compatible version on 
an SR 10 system. For more details, see Installing Software with Apollo's Release and 
Installation Tools. 

2.8 Installation of Pre-SRIO Optional Products 

The /instal!/sr9.7_compat directory contains tools for installing SR9.7-based optional 
software products that are compatible with SR 10 and are not being re-released with 
SR10. If the optional product uses the standard installation script described by Chap- 
ter 5 of Installing Domain Software , you should use the sr9.7_compat installation 
tools in place of the tools that were supplied with the optional product software when 
you install the software on an SR10 node. 

If you are installing any pre-SRIO layered products that are compatible with SR 10 and 
are not being rereleased at SR 10 onto an SR10 node, and you are not using the tools 
from /install/sr9.7_compat, you must set the INPROCESS and DOWNCASE environ- 
ment variables before running the installation script. 

Some layered products that were shipped before SR 10, including the Network Interface 
Definition Language (NIDL), require the existence of a /com directory before they can 
be installed. At SR 10, the /com directory is no longer automatically created when you 
install only UNIX environments. Therefore, a system that does not include the Aegis 
environment might not have a /com directory. In this case, you must create the /com 
directory before you install the optional product. 
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For the Versatec product, SFW-VERS, version 2.1, you must modify the build_ddf.sh 
script if you install the software in an SR 10 system. Change the procedure names 
VERS_$INT, VERS_$INTT and VERS_$CLEANUP to vers_$int, vers_$init, and 
vers_$cleanup. 

2.9 2DGMR Unbundled at SR 10 

2DGMR was made a layered product when we released Version 2.0, prior to SR 10. A 
revised version of this product (Version 2.1) runs on SR10. 2DGMR Version 1.0 was 
included in previous releases of software, but is not provided or supported on SR 10. 
For more information, contact your Customer Services representative. 
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Chapter 3: Fixed Bugs, Limitations, and Known Bugs 



This chapter documents bugs that we have fixed since SR9.7 as well as User Change 
Requests (UCRs) and Apollo Problem Reports (APRs) we have addressed. The chapter 
also documents all known limitations and bugs in SR10 standard software. 

We also ship, in hard copy only, a final bugs list. This list includes any bugs 
discovered, or fixed, after this document was completed. Consult that document, also 
shipped with the media kit, to ensure that you know of the final disposition of all bugs 
that are known to exist or that are fixed in this release. 

3.1 Bugs Fixed Since SR9.7 

The following subsections document bugs fixed since SR9.7 in the Domain/OS opera- 
ting system (kernel and libraries), the Display Manager, and various commands and 
utilities. 

NOTE: At beta we have documented only a few of the many fixed bugs . this list 

will be complete by FCS. 

3.1.1 Fork 

The UNIX fork () call now works after a GPIO device has been acquired; however, 
the GPIO device is not accessible to the the child process. In order for a device to be 
accessible to child processes after forking, the device must be a GPIO global device. 

3.1.2 The Bind Utility 

We have fixed the following bind bugs since SR9.7: 

• Prior to SR 10, the bind utility could not resolve UNIX symbolic links containing 
uppercase letters. We’ve fixed this for SR 10. The bind utility now resolves UNIX 
symbolic links in a case sensitive manner. 

• Prior to SR10, if a C program defined a malloc function (but no calloc function), 
then calloc would call the system malloc (stored in clib) instead of the user- 
defined malloc. We’ve fixed this problem at SR10. Now, calloc will call the 
user-defined malloc instead of the system-defined malloc. 

3.1.3 Domain/OS Calls and Insert Files 

The typedef of pgm_$argv in /sys/ins/pgm.ins.c was corrected from an array of 
pointers-to-int to an array of pgm_$argv_ptr, which are pointers to pgm_$arg. As a 
result, all C sources that using pgm_$argv will need to be fixed to not coerce args to 
(int *). 
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3.1.4 COFF UID 

A SR9.7 install bug caused the type uid for COFF to be wrong. All compilers that 
generate COFF output use the correct UID, 322.0, and all SR10 software uses the 
correct UID. As a result, if you do a /com/ld -type command on a directory con- 
taining COFF objects from an SR9.7 system, the command may report a type of 
type?, instead of coff. This is the only side effect of the SR9.7 bug, and you can 
correct this problem by using the following command to install the correct type UID 
on the SR9.7 node: crty coff -u 322.0 -r. 

3.2 Berkeley Distribution Bug Fixed 

We have fixed the following bug in the Berkeley Software Distribution: 

4.2BSD and 4.3BSD /usr/include/malloc.h declare the utmp struct ut_time field as a 
long. There is no guarantee on any UNIX system that a time can fit into a long. We 
therefore declare the field as a time_t. 

3.3 Known Restrictions at SR 10 

The following subsections describe restrictions and limitations at SR 10. 

3.3.1 Booting Diskless from DN5x0 Nodes 

You cannot use a DN550, DN560, DN 570, or DN580 (non-turbo) node with a 
Revision 16 ring board as the disked partner to a diskless SR10 node. You must 
upgrade your ring board to Revision 17. Earlier revision ring boards do not have this 
problem. 

3.3.2 EX D()MAIN_()S on DN5xO Turbo Systems 

You cannot use the MD EX DOVlAIN_OS command on DN5xO Turbo systems with 
the FPX floating point accelerator; instead you must use the EX AEGISFR com- 
mand. If you use EX DOMAIN_OS, the node proms will not load load the FPX 
microcode. 

3.3.3 Installation from Media 

The procedures for installing from distribution media always leave a /com directory on 
the node. If you are only installing UNIX environments, you can delete the /com 
directory tree after you have installed all software, including all layered products, from 
the distribution media. 

3.3.4 Aegis Shell 

The following restrictions apply to the Aegis shell. 

• Any program or shell script that the Aegis shell invokes must give execute permis- 
sion to the current user. This should not effect most SR9.7 scripts that were created 
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by the DM because the DM set the execute bit prior to SR 10. However at SR 10 
the DM does not set the execute bit. Therefore, you must use the edacl, chad, or 
chmod command to set the bit on any shell script created by the DM at SR10. 

Error input redirection from shell scripts and obj format files will continue to work. 
However COFF files do not have an error input (errin) stream and an attempt to 
directly redirect their error input (for example, if run by a shell script whose error 
is redirected) will result in an error message from the shell. 

Stdout and errout may be merged into a single file via (> foo >? foo). However 
since the buffering from a particular command may be different in one stream than 
in the other there is no guarantee that the messages will be placed in the file in the 
correct order. (Traditionally errout is not buffered and stdout often is when directed 
to a file.) 

Commands immediately after an arithmetic expression on the same line, such as 
a := 1; args foo 

will not work if the command has anything in it that could be interpreted as an 
arithmetic operator. 

The shell does not fail gracefully if the number of legal pipes in a single command 
line (approximately 120) is exceeded. 

In some instances the ’select’ builtin will treat arguments as numbers even though 
they have been quoted. 

There is currently no clean way to loop through an arbitrary number of arguments 
on the command line. However the following script will work for everything 
except null arguments: 




Software Release 10.0 — Beta2 Version: 4/19/88 



#!/com/sh 

eon 

# 

# Note that this will exit the loop early if there are any 0 length arguments. 

# 

for i := 1 to 99999 

arg := ""set -c args "V 
if eqs "arg ” then exit endif 

# Do your stuff here, 
args "arg 
endfor 

#Here’s the explanation, from the inside out. 

# 

# args ""i -> "1 

# set -c args "1 -> <argument#l> 

# 

# set -c is like saying ’sh -c’ except that it’s faster and takes place 

# at the current level. This would have worked with "sh -c" as well. We 

# are taking advantage of the fact that command line arguments after -c are 

# reparsed, so we get one extra level of parsing. 

# 

# Note: If you KNOW that none of your arguments have any spaces in them, 

# you can make this process much simpler by just saying: 

# 

# for arg in "* 

# 

# endfor 

3.3.5 C Shell 

You cannot set use the C shell limit command to set the stack size. 

The maximum token size in the C shell is 1020 characters; therefore you cannot use a 
file or directory name that exceeds this limit. 

3.3.6 BSD Bourne Shell 

The BSD Bourne shell does not give an error if you try to do multiple while redirec- 
tions. 

3.3.7 Aegis Commands in UNIX pipes 

An Aegis command may fail if it is used in a pipeline in a UNIX shell. For example, 
if you use pipe the output of /bin/cat into /com/fpatb while in a UNIX shell, fpatb 
will not search the entire contents of the file. 
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3.3.8 Aegis Commands 

The following restrictions exist in Aegis Commands. Also check the "Common Com- 
mands" restriction list for commands that are also available thorugh the /usr/apollo/bin 
directory. 

Id of SR 10 /dev If you issue a /com/ld command at an SR9.7 node to list 

one or more entries in an SR10 node’s /dev directory 
and specify an option that requests system type informa- 
tion (the -a or -st options), the output may include unex- 
pected characters, including non-printing and control 
characters. 

netstat The netstat -config command does not report the 

presence of floppy disk drives on DN3000 and DN4000 
systems because the floppy controller is pan of the win- 
chester controller. 

xdmc If you crp on a remote node and try to execute a DM 

command on the remote node by using xdmc in the crp 
window, the DM command executes on the local node. 
To execute a DM command on the remote node, enter: 

xdmc command > /dev/display 

in the crp window. It will have the side effect of pop- 
ping a window on the remote node, but it will work. 

3.3.9 Common commands 

The following restrictions apply to commands that are in the /usr/apollo/bin direc- 
tory; any restriction also applies to the version of the command that is in the 
/com directory, if there is one. 

crp Crp from pre-SR9.7 nodes to SR10 nodes does not work because 

pre-SR9.7 software does not understand the SR 10 directory format; 
crp does work from SR9.7 nodes to SR 10 nodes. You cannot use 
crp -me from an SR10 node to a pre-SR9.7 node if your working 
directory or naming directory is an SR 10 object. You can use crp 
-me to a pre-SR9.7 node if you first change your naming and work- 
ing directories to pre-SR 10 directories. 

If an SR10 node’s k node_data has tight protections, users from 
SR9.7 nodes may not be able to crp onto the node because crp 
creates a mailbox directly in the *node_data directory. 

tb The tb -args command is no longer supported due to limitations of 

the COFF format. Use the debugger to get the values of passed 
arguments. 

3.3.10 Commands and Files in /etc 
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The following restrictions apply to common commands and files in the /etc directory. 
See the "BSD Commands" and "SysV Commands" sections for any restrictions to /etc 
commands that are environment-specific. 

show_lc The show_lc command does not work on obj format files. 

nodestat The nodestat -c command does not report the presence of floppy 
disk drives on DN3000 and DN4000 systems because the floppy 
controller is part of the winchester controller. 

3.3.11 BSD Commands 



The following restrictions exist in BSD commands. Note that some restrictions that 
are listed for BSD commands may also apply to the corresponding SysV command. 

finger The finger command on a large network with many users can take a 
long time because it reads the entire registry. 

hostid The hostid command does not work. 

Is Because of the changes in ACLS and protections at SR 10, the Is 

command always reports that files on SR9.7 systems have extended 
ACLs. 



makewhatis The makewhatis command does not work because we do not supply 
unformatted man pages. 



3.3.12 SysV Commands 

The following restrictions exist in SysV commands. Note that some restrictions that 
are listed for SysV commands may also apply to the corresponding BSD command. 

hostid The hostid command does not work. 

Is Because of the changes in ACLS and protections at SR 10, the Is 

command always reports that files on SR9.7 systems have extended 
ACLs. 

nice The mapping of nice values into the underlying Domain/OS priority 

mechanisms is not one-to-one. While this doesn’t affect processes’ 
relative priorities, it may result in variations between the values as 
set by nice and those reported by ps. 

rm rm -r does not always remove a directory in a foreign (non- 

Apollo) file system; it fails if the current working directory and 
the directory to be removed have the same Date-time modified 
stamp. 

3.3.13 Access to New Object Types 

Pre-SRIO nodes cannot recognize object types that are new at SR 10. As a result, it is 
impossible for SR9.7 nodes to access or manipulate SR 10 character or block special 
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devices or to execute COFF object modules. The new types include: 
cmpexe 

coff (uid differs from SR9.7) 
console 

debug_* (eight types) 

dev_tty 

display 

group 

log 

nuls 

org 

osio 

passwd 

spe 

spmio 

spmio_9x 

uds 

3.3.14 ‘node_data 

At beta, the k node_data directory, and all its subdirectories except tmp and usrtmp 
must have their protections set so that all protections are inherited in an Aegis manner, 
that is, from the directories. 

3.3.15 in process 

The INPROCESS environment variable is no longer supported in UNIX shells. 

3.3.16 SR9.x File Ownership and Setuid 

SR 10 does not recognize (and cannot change) the UNIX owner and group on pre-SRIO 
files. Therefore you cannot run setuid programs on an SR9.x volume from an SR 10 
system. Also, if you use cpf -sacl or cpt -sael to copy any files from a pre-SRIO node 
to an SR 10 node, the owner of the copy will be set according to the SR 10 inheritance 
rules, and will not be the owner perceived on the SR9.7 node. 

3.3.17 8-Bit Font Support 

The following restrictions exist at beta in support for 8-bit fonts. See the next section 
for additional restrictions on 8-bit characters. 

• The fonts listed in the ’’Font Support" section of Chapter 1 are supplied only in 8- 
bit format, and cannot be used on SR9.7 systems. 

• Domain/Dialogue supports the new 8-bit font format. However, it does not support 
8-bit characters. Therefore, it is currently still limited to regular ASCII character 
set. 
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You can use the /sys/dm/cvt_font utility to convert 7-bit fonts to 8-bit format that will 
work with the DM and Domain/Dialogue. Therefore, you can save any existing 7-bit 
fonts, or create new fonts using the SR9.7 version of edfont. You can then convert 
these fonts to 8-bit format and have fonts with identical appearances in both formats. 

In this case you may have to resolve conflicting font names. 

3.3.18 8-Bit Character Support 

The following restrictions currently exist in support for 8-bit characters. In the fol- 
lowing descriptions, the term "8 -bit character" refers to a character where the eighth 
bit is set. 

• If you use an SR9.7 node to edit a file that contains 8-bit characters, the top bit of 
the characters in the lines that get edited are lost, and therefore the 8-bit characters 
are garbled. Similarly, if you copy a file whose name contains 8-bit characters to a 
9.7 node, you must change the name to one that only contains ASCII characters. 

• Pre-SRIO nodes cannot correctly read 8-bit characters. 

• User login names, node names, group names, and organization names can only 
include lowercase ASCII letters (a-z), numbers (0-9), and underscores (_). 

• Some SysV C Shell utilities will output 8-bit characters, while others do not. The 
shell terminates completely if you use a European character as input. 

• The BSD shells do not accept 8-bit characters on input or output. 

• Although most SysV shells and the Aegis shell support 8-bit characters on output, 
sorted output may not always appear in the expected order. Both SysV and Aegis 
sort all characters in numeric code order, but the two environments interpret the 8- 
bit characters differently. SysV interprets any 8-bit character as being negative, so 
Latin-1 characters sort before regular ASCII. Aegis considers the 8-bit characters 
to be positive; and, since their code values are higher than those for ASCII, Aegis 
orders Latin- 1 characters after regular ASCII. 

• DSEE does not support filenames that include 8-bit characters. 

• 8-bit support is included in the SR10 print server. However, only Postscript prin- 
ters support the full 8-bit character set. Some printers, such as Imagen printers, 
support only a subset, and some printers may require modifications. 

For example, if you have a printer that uses a daisy wheel or other mechanical 
impact device, you might have to replace the current font with one that includes 
the Latin- 1 characters. Similarly, you might have to load a language-specific 
PROM for a dot-matrix printer in order to generate the same characters on paper 
that you see on screen. If your printer font does not include a Latin- 1 character 
that is in your file, the system prints a blank. 

• At Beta, the following Latin- 1 characters do not print (you get a blank) when 
using a PostScript printer. 
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copyright sign 
soft hyphen 
registered trademark 
macron 

ring above, degree sign 
plus/minus 
superscript two 
superscript three 
superscript one 
fraction one-quarter 
fraction one-half 
fraction three-quarters 
capital icelandic ETH 
capital Y with acute accent 
capital icelandic THORN 
lowercase icelandic ETH 
lowercase Y with acute accent 

• At Beta, several Latin- 1 characters do not print correctly when using a PostScript 
printer. The following table lists the Latin- 1 character and the character that actu- 
ally is printed 

Latin- 1 Character Printed Character 



not sign 

micro sign u 

multiplication sign * 

division sign / 

lowercase icelandic THORN 

• Because the Domain C, Domain Pascal, and Domain FORTRAN compilers adhere 
to existing standards, none allow 8-bit characters in identifier names. All flag as 
errors any attempts to use European characters in identifier names. However, you 
can include 8-bit characters in strings and comments. 

3.3.19 Blasting Processes 

Blasting a process (by using the Aegis sigp -b or DM dq -bFR command, or by 
responding yes in response to a logout "do you want to blast" query) leaves many 
system resources in an indeterminate and unreliable state. If you must blast a 
process, you should then shut down to the menmonic debugger level and reboot, 
or at least exit to the boot shell, as soon as possible after blasting. This will res- 
tore the system resource state. 

3.3.20 getty On an Aegis-Only System 

Although the getty utility is in the common /etc, you cannot use it to control SIO lines 
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on a node where only Aegis is installed;' you must use the Aegis siologin utility. 

3.3.21 getty and uucp dialout 

SR10 does not support uucp dialout on a loine owned by getty. 

3.3.22 Cartridge Tape Drive 

You must issue a command to rewind a cartridge tape, such as the rbak -rewind com- 
mand, before you can access the cartridge tape. 

3.3.23 Printing 

Any applications which have bound a pre-SRIO /lib/prflib into the module will not run 
properly on an SR 10 node. These applications should be rebound with the -inlib 
/lib/prflib switch and should not have the prflib bound in. 

Ordinarily, in a mixed environment of SR 10 and pre-SRIO systems the /sys/print 
directory must be located on an SR9.7 node; otherwise, users on SR9.7 nodes cannot 
queue jobs. However, the /sr9.7_compatibility/sr9.7_executables directory contains 
versions of /com/prf and /lib/prflib that overcome this restriction. If you install these 
items on the SR9.7 nodes in place of the original prf and prflib, you can then put the 
/sys/print directoiy on an SR 10 node and queue succesfully from the SR9.7 nodes. In 
all cases, the print manager and print server can run on SR10 or SR9.7 nodes. 

If you find it necessary or desirable to put the spool directory on an SR 10 volume, 
then you must copy /lib/prflib and /com/prf from the 

/sr9.7_compatibility/sr9.7_executables directory to the SR9.7 nodes on your network. 
At Beta, Headers and footers are printed only on PostScript printers. 

3.3.24 Links 

Domain/OS soft links are not objects. As a result, the links themselves do not have 
protections (although the objects to which the links point, of course, do). Similarly, 
they do not have dateAime stamps. The UNIX stat call and Is/fR command report 
the date-time modified of the directory that contains the link as the links 
modification time. 

3.3.25 COFF Objects and Type Managers 

Objects compiled by using the standard SR10 tools are in COFF format and will not 
execute under previous releases. If you write a type manager and want it to be usable 
from SR9.x systems, do not use the COFF compiler and tools. The managers must be 
in "obj" object format to interoperate with SR9.x nodes and allow you to share files of 
that type between SR 10 and SR9.x nodes. However, if you do not want the type 
manager to be usable with SR9.7 nodes, you should use the COFF tools. Note that 
you should specify position independent code for COFF managers. 
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Normally, if you create a new type and manager on any node and create files with that 
type, other nodes can see that object even if you have not installed the type manager 
on them. If the other node lacks the new type manager, it tries to use the type 
manager from your node (where the file was found). However, if you use COFF for 
that new type manager and the other node is running a pre-SRIO release, that node 
cannot load your COFF type manager and cannot read your new files. 

3.3.26 COFF objects and the DM 

If you use an SR10 compiler under any of the follwoing conditions, the resulting 
COFF file will appear to be an ascii-readable file and the DM will attempt to open a 
pad on it if you try to read the file. 

• Build on a SR9.7 node and send the output to an SR 10 node 

• Build on a SR9.7 node and send the output to an SR9.7 node 

• Build on a SR 10 node and send the output to a SR9.7 node 

3.3.27 Creating .bak Files from SR9.7 Nodes 

It is possible for a program on an SR9.7 node to use ms_$mk_permanent ( or any 
other call that generates .bak files) and cause an SR 10 node to create a backup file. If 
the original file name exceeds 28 characters, the call would normally create a .bak 
name that exceeds 32 characters. However, to ensure that the SR9.7 node that is 
creating the file can also access it, the software truncates the original file name to 
ensure that the backup file name, including .bak, does not exceed 32 characters. The 
filename is not truncated if a program on an SR10 node makes the call. 

3.3.28 rbak of SR10 nodes by SR9.7 

The SR9.7 version of rbak cannot restore SR 10 nodes. The 

/sr9.7_compatibility/sr9.7_exeeutables directory contains a version of rbak that runs 
on SR9.7 systems and can restore SR 10 nodes. 



3.3.29 The stream_$redefine Call 

You can execute a stream_$redefine call to convert an unstructured format file (such 
as COFF or unstruct type files) to a file with a streams header (such as uasc or obj) 
before writing to the file. However, you cannot redefine an unstructured file to a 
streams file after writing to it. This limitation is the result of the differences in 
streams files and unstructured files. Streams-format files begin with a header, while 
unstructured files do not. Once the unstructured file is written to, the redefine opera- 
tion cannot create the required streams header. 

Note that the stream_$ interface, including the stream_$ rede fine call is superseded by 
the ios_$ interface. 
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3.3.30 pfm_$cleanup Call 

At SR10 pfm_$cleanup does not automatically release the cleanup handler at end of 
normal execution. If you issue a pfm_$cleanup call you must now always explicitly 
issue a pfm_$Hs_cleanup call at the end of normal execution. 

3.3.31 UNIX nice Call 

The mapping of nice values into the underlying Domain/OS priority mechanisms is not 
one-to-one. While this doesn’t affect processes’ relative priorities, it may result in 
variations between the values as set by nice and those reported by ps. 

3.3.32 SysV open Call 

The sysV open call ()_SYNC option has no effect. 

3.3.33 BSD ttyslot Call 

The BSD ttyslot call returns the slot number of a tty in the /etc/utmpfile, not the 
/etc/ttvs file. ! 

3.3.34 Registry Creation 

You can now create a registry for the first time by using the new create_rgy com- 
mand. This command is shipped only in the /install directory on the boot media, and 
is not copied across the network by the normal installation procedure. If you use this 
command, you will automatically get passwords on all the canned accounts. The 
password is - apollo -. The account for user has the password - apollo - also, but if you 
login using the full text user.none.none, you do not need a password. 

If you want to use your existing 9.7 registry, you must use 

/sr9.7_compatibility/sr9.7_executables/com/cvtrg to ccreate an SR 10 registry from 
you SR9.7 registry. This program mns on SR9.7 nodes only. At beta you may want to 
make a copy of your SR9.7 registry first and then run cvtrgy against that to create 
your SR 10 registry. 

3.3.35 TCP/IP 

SR 10 TCP/IP locates its administrative files in the /etc directory, while the layered 
SFW-TCP product that ran on Aegis-only systems in earlier releases located the 
administrative files in the /sys/tcp directory. Also, we recommend that eacg network 
have only one administrative node. As a result, there can be administrative problems 
if the TCP/IP administrative node on a network with both SR 10 and pre-SRIO TCP/IP 
users is an Aegis-only SR9.7 node, or an SR 10 node. 

We recommend that, if you have both SR 10 TCP/IP users and pre-SRIO Aegis-only 
TCP/IP users, your TCP/IP administrative node should run SR9.7 Domain/IX. (You 
should install Domain/IX if it currently runs only Aegis.) This way, the node can then 
serve both SR9.7 Aegis TCP/IP users and SR 10 TCP/IP users since it will have both 
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/etc and /sys/tcp directories. 

3.3.36 UUCP 

Domain/IX (pre-SRIO) UUCP can not share spool queues with the SR10 UUCP. The 
/sr9.7_compatibility/sr9.7_executables directory contains versions of the HoneyDan- 
Ber UUCP that you should install and run on SR9.7 systems in a mixed network of 
SR10 and pre-SRIO systems. These versions can share pool queues with SR10 UUCP. 

3.3.37 SAX on a 30MB disk 

/systest/sax requires approximately 1 1 megabytes of free disk space. As a result, it 
will mn out of disk space on a 30MB disk or on a disk that is nearly full. 

3.3.38 GPR 

On DN570 and DN570T systems the maximum size of a hidden bitmap is restricted to 
224 X 214 and not the documented 224 X 224. 

3.3.39 SysV open call 

SR10 does not support the System V Release 3 open(2) call’s 0_SYNC mode. 

3.3.40 Layered Products that Do Not Work On SR 10 

The currently released versions of layered products are known not to work on SR 10 
systems at Beta2. 

ADA (An interim version is available on special request) 

Common Lisp (An interim version is available on special request) 

Modula 2 
RJE 

PostScript 
DPCI-1 3.0 
DPCI-Ring 1.0 
DPCC 2.1 
DPCC-Remote 1.1 
DPCE 1.0 

2DGMR 2.0 (An interim version is available on special request) 

Interleaf (An interim version is available on special request) 

Alis 
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3.3.41 C Compilers 

You cannot us the SR10 version of /bin/cc as a front end to the SR9.7 version of 
/fB/com/cc; you must use the version of /bin/cc that is in the /sr9.7_compatibility 
directory. 

3.3.42 GPIO 

If a GPIO library is in SR9.2 object module format, it cannot be loaded on an SR 10 
system. 

3.3.43 Domain/Delphi 

The Domain/Delphi loader will not work unless you first install the SR 10 D3M run- 
time unit, not the one shipped with Domain/Delphi. You only need the 
Domain/Delphi loader to load new books into a Domain/Delphi database. SR10 docu- 
mentation is not available through Domain/Delphi at beta. 

3.3.44 Open Systems Toolkit 

Managers must be compiled or bound as position independent code. 

At SR10 there are additional trait constant files in the /sys/traits directory. These files 
have a suffix of .2, for example ios_dir_trait.2, and include currently-unreleased addi- 
tional operations that are used by certain software products at SR 10. You should con- 
tinue to bind type managers to the trait constant files without the suffixes, for example 
ios_dir_trait. 

3.3.45 DSEE Tutorial 

The DSEE Tutorial’s Libraries Discussion Topic will omit figures or redraw the figures 
at the wrong time if you replay a segment. 

3.4 SR10-Related SR9.7 Restrictions 

SR9.7 systems cannot execute shell scripts that are in unstmct format files (as opposed 
to usac files). 

3.5 Known Bugs at SR 10.0 

The following subsections describe known bugs at SR 10. 

3.5.1 Base Software Installation 

The following installation bugs are known at beta: 

Closed ACLs and /etc If you install with closed ACLs, several files in /etc 

currently get protection mode 777. 
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/etc/syslog.conf The installation procedure does not create a default 

/etc/syslog.conf file. The man page provides help on 
creating it. 

/etc/inetd.conf The template /etc/inetd.conf/fR file does not include an 

entry for the BSD ntalkd daemon. 

Media Installation You cannot install from the distribution media onto a DSP 

server node; the node must be a workstation with a full 
display. 

DTEK Release Notes Release notes are not available for the layered DTEK 4014 

product at beta. 

install++ The install++ tool runs the installation procdure even if you 

abort from the configuration procedure. 

You should also check Chapter 4 of these release notes for any additional installation 
information procdueres that are required as a result of beta bugs. 

3.5.2 NFS Installation 

The NFS intallation procedure prints the following message: 

"check the file /etc/rc.tep for instructions on how to run TCP/IP" 

The file name is incorrect; it should be /etc/rc.Iocal. 

3.5.3 C Compiler Installation 

The C compiler always creates a /sr9.7_compatibilitv directory, even if your 
configuration that does not include this tree. 

3.5.4 No Shell After Invol 

If you install on an involed node, boot it up, and then log in you may get no shell the 
first time if your shell is a link to another node. This is because your node hasn’t 
found the naming server yet and thus doesn’t know any node names. 

3.5.5 DM Display of Tabs 

THe DM currendy converts a tab character into 8 times the width of a space character; 
as a result the spacing of text with tabs is incorrect. The DM will use a spacing of 8 
times the width of the character "n" by FCS. 

3.5.6 Init 

If the DM fails to load, init continually attempts to load it. 

On a node where the SPM runs in place of the DM, i.e., a server node without a gra- 
phic display, the SPM quit command should shut down the SPM, leaving the system 
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in the boot shell. Instead, the init process automatically restarts the SPM. 

3.5.7 DM Boot over SIO line 

You cannot boot the DM over an SIO line. 

3.5.8 calendar and invol 

The calendar and invol standalone utilites (saus) truncate messages that are longer 
than 80 characters. 

3.5.9 UNIX Default quit Character 

When the standard keyboard or user-defined key definitions are not in effect, for exam- 
ple in the vtlOO emulator or over an SIO line, the default quit character is CTRL-? 
instead of CTRL. 

3.5.10 Aegis Shell 

The following bugs are exist in the Aegis shell. 

• Aegis wildcards do not support ../<wildcard> at Beta2. 

• A leading period (.) in a pathname that includes wildcards is interpreted as mean- 
ing the current working directory, even if it is not followed by a slash separator. 
Thus, .csh?* is interpreted as meaning any object in the working directory with a 
name that starts with csh. 

3.5.11 Aegis Commands 

The following commands in the /com directory currently have bugs. You should also 
check in the "Common Commands" and "/etc Commands and Files" bug listings below 
for bugs additional commands. 

chuvol The chuvol command is not installed at beta. (This command is a 
link to /etc/chuvol, which is not installed. 

mtvol The mtvol command may report the following error even though it 
mounts the volume correctly: 

"unable to add entry to mount table" 

netstat The netstat command returns without an error message if it does not 
find the node for which information was requested. 

tctl The tctl command does not parse the command line arguments 

correctly. 

vsize The vsi/e command is not installed at beta. (This command is a 
link to /usr/apllo/bin/vsize, which is not installed. 
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3.5.12 Common Commands 

The following bugs exists in commands that are in the /usr/apollo/bin directory; any 
bug also applsy to the version of the command that is in the /com directory, if there is 
one. 

chad You cannot use the chad command to setuid. 

The chad functionality for setting the owner, group and organization 
does not work correctly. 

crp You cannot login when using crp from the single user shell, that is 

when in a shell that is invoked from the bootshell. This is true both 
for the crp command with no options or crp -login user_name. 

You can us crp -me. 

If you use the UNIX man command when in a crp window, the 
working is set to the man directory. 

dbacl The dbacl command allows you to add users but does not update its 
display to include the new information. It also has problems setting 
the local access only bit, with initial file acis, and with directory 
acls. 

emt You cannot use emt if you do not have a /com directory. 

systype systype currently returns a "not an object file" error message if you 

do not have read permission on the file. 

vsize The vsize command is not installed at beta. 

wbak You can get the fowllowing error when running wbak: 

?(vfmt) Error writing to stream 3, status 1080001 

This error is caused by wbak attempting to write to both standard 
stream 3 and the errout stream. 

An attempt to back up an object where the full path exceeds 1024 
characters results in a guard fault. Note that this bug applies to the 
resolved path, not the absolute pathname; absolute pathnames cannot 
exceed 1023 characters. 

3.5.13 /etc Commands and Files 

The following bugs exist commands and files that are located in /etc: 

chuvol The /etc/chuvol command is not installed at beta. 

getty /etc/getty displays a banner saying bsd under all environments, 
including SysV. The banner may be garbled when you use a 
dialup line. Getty is still working in both these cases. 

nodestat The /etc/nodestat command returns without an error message if it 
does not find the node for which information was requested. 
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writed The /etc/writed daemon is not installed at beta. 

3.5.14 SysV Commands and Utilities 

The following bugs exist in SysV commands. Note that some bugs that are listed for 
BSD commands may also apply to the corresponding SysV command. 

find find -local does not currently work 

vi Vi does not work over dialup lines. 

3.5.15 BSD Commands and Utilities 

The following bugs exist in BSD commands. Note that some bugs that have been 
reported for SysV commands may also apply to the corresponding BSD command. 

df The df command cannot see devices that are mounted on SR9.7 sys- 

tems because df now looks for devices in /etc/mnttab; at SR9.7, 
only NFS supported this file. 

nm The nm command does not work with obj format files. The BSD 

nm -og command lists the archive name, instead of the names of the 
objects that make up the archive, with the symbols and values. 

man -f and apropos The man -f and apropos commands do not work. To 
make them work, move /usr/lib/whatis to /usr/man/whatis. 

vi The BSD implementation of vi has the known Berkeley distribution 

bug that causes macros to destroy file text. 

3.5.16 telnet 

The telnet delete key does not work. 

3.5.17 /usr/adm/lastlog 

Although the beta software installs a /usr/adm/lastlog file, we do not support it. 

3.5.18 Keys Set by kbm 

If you use the kbm command to set a key specification such as the compose key, third 
party software cannot reset the meaning of that key. 

3.5.19 Lost Keyboard Events 

D3000, DN4000 and DN5xx-T can lose typed characters, for example if you type 
"abcdefg" you may only get ”abc". 

3.5.20 Printing 
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the following bugs are known in the printing software: 

• The following lowercase characters do not currently print correctly on a PostScript 
printer: 

i with grave accent 
i with acute accent 
i with circumflex accent 
i with diaresis 

• A storage allocation bug exists in the filters in prsvr that use tmtlib. This problem 
occurs primarily in the non-PostScript printers that process text jobs. Jobs that are 
sent to printers in bitmap or transparent mode do not experience this problem. 

When you use a filter in the print server that uses tmllib, storage is not released. 
The lost storage for each text job is approximatly the size of the text file. Eventu- 
ally the disc will become full. To correct this condition restart prsvr. This will 
free the allocated storage. 

• The example programs for writing drivers and filters are not included in this 
release of the software. 

3.5.21 gm_$init, Domain/Dialogue 

The gm_$mit call fails the first time it is called, but works the second time. 
Domain/Dialogue uses this call to initialize graphics areas; therefore some 
Domain/Dialog applications may fail. 

3.5.22 vfmt Calls 

The vfmt calls do not properly handle a decimal value of -32768 when using the 
%wpd%$ format string. The resulting output is -4294934528. 

3.5.23 smdu Insert Files 

The smd_$ interface is superseded. Although the beta software includes 
/svs/ins/smdu.insjtxv insert files, they will not be shipped at the FCS. 

3.5.24 getpass and /bin/login 

The UNIX getpassO call fails from an SIO line when there is no controlling tty. As a 
result /bin/login fails to get the password in such cases. 

3.5.25 closedi r 

The UNIX closedir call memory faults on a NULL pointer. 

3.5.26 UUCP 

Because the UUCP lock directory is local per node, if two users linked to the same 
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uucp site node attempt to uucp or uux to the same remote system at the same time, 
there may be a sequence number conflict. 

* 

UUUCP does not curremdy support communication over TCP, TLI, or X.25. 

3.5.27 GPIO 

If you have global GPIO devices loaded, you must exit to the boot shell prior to shut- 
ting the machine down. 

3.5.28 DDE 

The following bugs are known in the Domain/DDE debugger: 

• The debugger interprets -type and -on arguments appearing in the program invoca- 
tion as its own arguments. To workaround, invoke the debugger with no 
arguments and use the Domain/Dialogue interface to the DEBUG command. 

• These commands do not work well at Beta2: 

• TRACE 

• WATCHPOINT 

• The following command/option combinations do not work at Beta: 

• GO [-signal expression I -ignore] 

• STEP [-signal expression I -ignore] 

• The following additional problems are known: 

• All references to names in the program are case sensitive. C is case correct, but 
in other languages, use lower case. 

• SEARCH with no arguments (repeat search) does not work. 

• No source display if the dde window is totally obscured when dde is invoked. 

• The AGAIN key does not work from the debugger input pad until after the cur- 
sor has entered the debugger display area once. 

• Some keys cannot be defined using the KEY command. This is so they can 
retain the user’s DM key bindings. 

• You cannot use the debugger to assign conformant arrays in Pascal. 

• Argument information is sometimes unavailable in FORTRAN. 

• If the debugger’s request to load the program fails, the debugger says the pro- 
gram exited, without giving an appropriate error message. 

• If watching or tracing is on, STEP -OVER steps into routine. 

• Variables declared in unnamed C inner scopes cannot be referenced. (This is 
caused by a compiler bug). 
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• If the debugger is tracing or watching at statement granularity, STEP 
-INSTRUCTION does not produce the right results. If it is tracing or watching 
at statement granularity in a particular routine, STEP does not produce the 
right results. 

• Displays may be an annoying color if you don’t use the default color map. 

• The debugger cannot find the correct address for variables in registers in code 
ranges that have been optimized away. (This is caused by a compiler bug). 

• If you are debugging a obj format file and set your environment to a module, 
then no source will be displayed and line number references will not be recog- 
nized. Use env Nproc instead. 

• If you scroll the transcript up to look at something, then move the cursor into 
the display area, the transcript jumps back to the bottom. 

• The debugger cannot reference variables that are not in the current environ- 
ment, e.g., local variables in a different stack frame. 

• The DM tn (to_next_window) command will not go to the display area. 

• If the following warning appears occasionally, it can be ignored: 

(Warning) Found more than one symbol called "- — 

• Named string constants have type char (obj only). 

• Syntax error reporting in Pascal is poor. 

Use the following procedure to report any additional bugs that you may discover in the 
debugger: 

1. Run the debugger with prop echo -pretty or prop echo -graphic, if possible, to 
transcript the commands given via menus, keybindings, and macros. 

2. Include in your bug report: 

• The version of the debugger; use the version command 

• A description of the problem 

• A transcript of the whole debug session (if possible) 

• All the applicable error log entries (from 
‘node_data/system_logs/debug_error_log) 

• A small test program, if possible 
3.5.29 Pad Manager 

The pad manager will ignore a use_font in a frame; it can’t put back original font after 
the frame is closed and deleted. 

If you do an conditional pad get (ios_$get with ios_$cond_opt/) and something is 
obtained (that is, something was stacked in the input pad waiting to be read), then hen- 
ceforth input to the pad is read immediately and more stacked input moves to the 
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transcript before it should. 

3.5.30 Tools Not Available at Beta 

dbx, prof, and gprof are not in beta but will be available by FCS. 

3.5.31 DN5xO-T Cartridge Tape Access 

An attempt to access a cartridge tape drive on a DN5x0-T (Turbo) system that does 
not have a cartridge tape drive and does have a disk drive crashes the node. 

3.5.32 DN5xO Initialization Messages 

DN5x0 Systems may not display the Apollo logo and may clip the firs character of the 
startup banner at boot time. 

3.5.33 Documentation Bugs 

The following documentation errors exist at beta2. 

chad You must use I and not i to specify the ignore bit when you 

use /usr/apollo/bin/chacl. The man page incorrectly indicates 
that you should use the lowercase character. 

General Errors The UNIX man pages currently have several errors where they 
refer to unsupported facilities and hardware such as 
/dev/kmem, 3b2 hardware, etc. 

Underscores In some cases, underscores may appear to be "strange". 
3.5.33.1 GPR 

When using gpr_$text on a DN3000 high resolution monochrome workstation with a 
large number of font files, (more than approximately 40) there is a small probability 
that a spurious "bad font file" (symbol gpr_$bad_font_fi!e) status will be returned, 
and the text will not be drawn. 

This problem is most likely to occur when GPR is being used either in borrow mode, 
or in direct mode with little or no other activity on the screen. 
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Chapter 4: Installing SRIO 



SR 10 provides a completely new set of tools for installing Domain software. Instal- 
ling Software with Apollo’s Release and Installation Tools provides detailed instruc- 
tions for using these tools to install standard system software on Domain workstations 
and servers. However, see " Beta Installation Considerations " below for installation 
information that applies at Beta. This chapter contains information on the /install/fR 
directory used by the new installation tool and about other installation-related 
tools. It describes any special installation considerations that apply at Beta. An it 
provides a list of media on which this release is distributed. 

4.1 The /install Directory 

As part of the change to the install procedures, we have changed the use and contents 
of the node /install directory. The top-level /install directory on the average user’s 
node no longer contains installation scripts. Instead, it contains the following: 

• a baseline directory. This directory holds baseline files for the node on which it is 
located. A baseline file is a record of the state of the node, in terms of products 
installed and options selected, as of its most recent installation. The new install 
tools create a new baseline file, and optionally purge the old files, every time they 
are run. 

Because the existence of a baseline file on a node speeds up subsequent installa- 
tions of software to that node, we recommend that users not delete this file or the 
/install directory in which it is stored. 

• a configuration directory (optional - created by the node owner). This directory 
contains configuration files. Configuration files are formatted lists of products and 
product options that the install tool uses as input to determine what objects to load 
during an installation. They are created by the config or the install++ tool, or you 
can use default configuration files provided by Apollo with the software. 

• a doc directory, which contains the apollo directory. The /install/doc/apollo direc- 
tory contains the SR10 software release notes, release notes for optional products, 
and Making the Transition to SRIO Operating System Releases. This directory also 
contains an informal file of answers to commonly asked questions about SRIO. 

• a preserve.list file that contains a list of files on this node that are not to be 
changed by the installation. 

• a not_installed file that contains a list of files that could not be installed during the 
last installation session. 

• a not_installed.temp file that contains a list of files that could not be installed 
during the last installation session. The install tool goes back and forth between 
this file and the previous one. At the end of an installation, this file is deleted. 



Installation 



4-1 




Software Release 10.0 - Beta2 Version: 4/19/88 



If a node or file server is used as an Authorized Area - that is, a source area for instal- 
lations over the network - its /install directory contains all the files and directories 
listed above, as well as the following objects: 

• Release Index subdirectories. These directories* names all begin with "ri.". Each 
release index directory is associated with a single released product. The product 
may be the base OS software with the three operating environments, or it may be a 
layered product like Domain FORTRAN or Domain/Dialogue. Its release index 
directory contains all the objects belonging to the product, including the binary 
release index that is the blueprint for that product’s installation. 

• an /install/tools directory containing the complete set of SR 10 installation tools. 

• an /install/help directory containing online help files for the tools in the 
/install/tools directory. 

• an /install/overrides directory for files to control the configuration choices availa- 
ble to ordinary users. We ship some files in this directory. 

• an /install/templates directory containing ‘canned’ configuration and Authorized 
Area selection files provided by Apollo. 

• an /install/sr9.7_compat directory containing SR9.7 style install scripts. These 
scripts are for use with optional products that can run on SR 10 nodes but are not 
being re-released with SR 10. 

• an /install/<site> directory created by the site system administrator and containing 
site-specific configuration, override and Authorized Area selection files. 

4.2 /etc/in voke_script 

A new script /etc/in voke_script invokes either an Aegis shell script or a Bourne shell 
script, depending upon the environment or environments installed on the system. This 
tool is useful if you wish to use shell scripts to install non-Apollo software and cannot 
be sure which environments will be available on the node where the software is being 
installed. 

4.3 Beta Installation Considerations 

Appendix A of Installing Software with Apollo's Release and Installation Tools descri- 
bes how to install the Domain/OS operating system on the first SR10 node in your 
network. If the disk on which you create the first Authorized Area is big enough to 
hold the optional software products shipped with the Beta release, the Appendix A 
procedure also allows you to install optional software on the first node. If you do not 
install optional software as part of the procedure in Appendix A, follow the directions 
for creating an authorized area in Chapter 3 of Installing Software with Apollo’s 
Release and Installation Tools. 

4.4 Media Types 

We distribute SR 10 on magnetic tapes, 1/4-inch streaming cartridge tapes, 5-1/4-inch 
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floppy disks, or 8-inch floppy disks as indicated in the following subsections. 

4.4.1 Magnetic Tapes 

Magnetic tape distributions of SR 10 are not available at the Beta release. 

4.4.2 Streaming Cartridge Tapes 

Streaming cartridge tape distributions of SR 10 consist of the following tapes: 

CRTG_STD_SFW_V()L 1 SR 10.0 
CRTG_STD_SFW_V()L2 SR 10.0 
CRTG_STD_SFW_V()L3 SR 10.0 
CRTG_STD_SFW_V()L4 SR10.0 

4.4.3 Floppy Disks 

Floppy disk distributions of SR 10 are not available at the Beta release. 

4.5 Release Configurations 

SR 10 is shipped with several prespecified configurations for installation, as described 
in detail in Installing Software with Apollo’s Release and Installation Tools. In parti- 
cular, there are configurations that install all Domain software or subsets that are likely 
to be of interest to users with local disks of various sizes. 
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Chapter 5: Documentation 



This chapter describes the new documentation at SR 10. We start with an introduction 
that gives you an overall view of the SR10 documentation set and describes changes 
we’ve made in the set at SRO. The rest of the chapter describes the changes in indivi- 
dual documents. 

5.1 Introduction to SR10 Documentation 

This introduction contains the following sections: 

• Organization of the set at SR 10 

• Changes in the documentation to help you find information more easily 

• SR 10 books and their relation to earlier versions 

5.1.1 Organization of the Documentation Set 

We’ve organized the SR 10 documentation set to fit the single operating 
system/multiple environment strategy of Domain/OS. Our goal was to create 
environment-specific manuals for the Aegis, BSD, and SysV environments whenever 
that made the information easier to access and use, but to provide one manual for the 
three environments in all other cases. We provide Aegis, BSD, and SysV versions of 
the: 

• Task-oriented user’s guides ( Using Your .... Environment) 

• Command references (.... Command Reference) 

• Programmer’s references (.... Calls or Programmer' s Reference) 

• System administration guides ( Managing ...System Software) 

For basic shell command, call, or system administration information, refer to the 
manual for the environment(s) you will use. For basic tutorial information (< Getting 
Started with Domain/OS ), software installation information, SR 10 transition informa- 
tion, Display Manager information, and any application information such as debugging 
or networking tools such as TCP/IP, refer to the application-specific manuals. These 
are appropriate for any environment. Documentation for hardware products and 
optional products is also appropriate for any environment. 

For example, if your site plans to install and run BSD in your network, you will be 
using environment-specific manuals such as Using your BSD Environment, the BSD 
Command Reference, and the BSD Programmer's Reference. You’ll also use 
application-specific manuals such as the Domain Distributed Debugging Environment 
(DDE) Reference and the Domain Display Manager Reference. (Note that Display 
Manager (DM) commands now appear in this separate DM manual, which is relevant 
for whatever operating environment you are using.) Beginning users can use Getting 
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Started with Domain/OS. 

At SR10 we sell documentation in packages customized for any one environment, or 
for all three environments. These custom or general packages are available for general 
users, programmers, or system administrators. 

5.1.2 Locating Information in the Documentation Set 

SR 10 provides a number of features to help you more easily locate the information 
you need. They are: 

• Identifying information on manual spines 

• Domain Documentation Master IndexfDomain Documentation Quick Reference 

• On-line manuals list available through man or help 

• Domain/Delphi 

• System call information available through man or help 

• Man pages available through the HELP key 

• Improved indexes in individual manuals 

As you will note when you unpack your SR10 manuals, we now provide a built-in 
binding for our user manuals. Besides holding the book together and eliminating the 
need to order separate binders and labels, the binding mechanism provides a spine for 
each manual. The spine identifies the manual and allows you to easily locate books on 
a shelf. 

The spine of each manual contains the manual’s title and an icon that shows the 
manual’s type. You can use the icons to help you organize your manuals on a shelf. 
For example, you might want to put all the software tools manuals together. You can 
do this easily by grouping the books that contain a tool icon. (The Domain Documen- 
tation Quick Reference , described next, shows all the icons and the books in each icon 
category.) 

The Domain Documentation Master Index and Domain Documentation Quick 
Reference are two new tools for locating the proper manual in your hardcopy docu- 
mentation set. The Master Index is an index of topics related to our software and 
hardware, and a reference to the manuals that discuss these topics. The Master Index 
also contains a complete list of manuals with their current part numbers and a descrip- 
tion of each manual. This manual and the Domain Documentation Quick Reference 
replace the Technical Publications Overview. 

The Domain Documentation Quick Reference is a folding card that also lists all the 
manuals in the documentation set, by category and icon. Use this card to help organ- 
ize your bookshelf and get the right information when you need to order new manuals. 
For several releases, a similar list of manuals and their current revision numbers has 
been available online through the help manuals command. Now you can now also 
access this file by using either the UNIX man manuals or the Aegis help manuals 
command, (man manuals does not work at beta.) 
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The Domain Documentation Master Index is a hard-copy method of locating informa- 
tion in the documentation set. 

At SR 10, a number of manuals are available through the optional Domain/Delphi pro- 
duct, our online documentation retrieval system. Domain/Delphi provides sophisticated 
keyword search mechanisms, allowing you to browse online to retrieve online informa- 
tion about a particular subject, or access information sequentially as you do in a 
hard-copy book. You do not even need to have on hand hard-copy versions of manu- 
als available through Domain/Delphi. At SR 10, the following manuals are available 
through Domain/Delphi. 

SR 10 documentation is not avaialable through Domain/Delphi at Beta. 

• (to be added) 

At SR10, you can access online documentation about programming calls for any 
environment via the help or man commands. Prior to SR 10, only UNIX programming 
call man pages were available on line, via the man command, and summaries of the 
OS call interfaces were available through the Help facility. Now, you can also use 
the helpFR or man command to access detailed manual pages for Domain/OS calls. 
For example, to get information on the ios_$open call from an Aegis shell, you would 
enter 

help call ios_$open 

Note that you must specify the word call before the call name. To get a man page for 
the same call from a UNIX shell, you would type 

man ios_open 
or 

man a ios_open 

where a is the section specifier for Domain/OS calls. Note that you should not include 
the $ (dollar sign) character in the call name; This eliminates the need to escape the $, 
which has special meaning in most UNIX shells. 

We also provide "intro" section pages for each set of calls that can be accessed by just 
specifying the prefix, for example: 

man a ios 
or 

help calls ios 

We have changed the default definition of the HELP key in UNIX environments so 
that the key will read man pages rather than help files. 

At SR10 we also paid particular attention to the individual indexes in each manual. 

To help you locate release -related information, the SR 10 Standard Release Document 
now contains an index. (Not at Beta, however) 

5.1.3 Manuals at SR10 

This section highlights some of the most important SR 10 manuals. We also list the 
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Domain/OS manuals that are new or revised at SR 10, and indicate the equivalent ver- 
sions of earlier manuals. 

5. 1.3.1 Key SR 10 Manuals 

The SR 10 documentation set contains a number of new and revised manuals. This sec- 
tion details some of the manuals that are critical for upgrading to the new release, and 
using the new software effectively. 

Making the Transition to SR10 Operating System Releases is the first book you should 
read about SR 10. Plan to read this book before you plan your upgrade to SR 10. An 
important source of information for this book was the SR 10 transition experiences of 
beta test users and internal Apollo users. So we think it should be particularly useful in 
guiding you through your transition. Install SR 10 only after reading this manual 
thoroughly! 

SR 10 provides a powerful and flexible new set of installation tools. Installing 
Software with Apollo's Release and Installation Tools is required reading before using 
these tools to install standard or layered software. 

The Domain Documentation Master Index , mentioned previously, is a critical manual 
because it guides you to the manuals that are most appropriate for getting information 
about each component of Domain/OS and its three operating environments. 

5. 1.3.2 SR 10 and Pre-SRIO Manuals 

This section lists the Domain/OS manuals that are new or revised at SR 10, and com- 
pares them with the pre-SRIO document set. We include this information because, in 
addition to revising many manuals, we have changed the organization of the document 
set to reflect the new structure of Domain/OS. In some cases the manual has changed 
name and/or part number between SR9.7 and SR 10, but still provides the same type of 
information. In other cases, we have reorganized information into different manuals. 
For example, the Domain System Command Reference no longer exists; the Domain 
Display Manager Command Reference and Aegis Command Reference replaced this 
manual. Other manuals are completely new at SR 10. Also, our part number scheme 
has changed somewhat, as described next. 

Prior to SR10, manuals typically had a six-digit part number that stayed the same from 
release to release. Manual part numbers at SR 10 have a six-digit base number and a 
three-digit suffix. For hardcopy documentation, the three-digit suffix begins with A. 
Typically, we increment the suffix every time we revise a manual. So, for example, the 
SR10 version might be 01 1022-A00 and the next revision might be 01 1022-A01. This 
new numbering scheme will enable us to maintain two versions of one manual at the 
same time. 

When we mention manual part numbers in our documentation, we usually only men- 
tion the base number, and not the suffix. When you see the base number, we are 
referring to the most recent version of the manual. However, when we show the entire 
part number, we’re referring to the specific version that had that part number. In the 
manual correspondence table that follows, we show complete part number information. 
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The following table lists the Domain/OS software manuals that are new at SR 10. It 
lists the manual name and part number at SR 10, and the equivalent name and part 
number at SR9.7. It does not list manuals for layered products that have been revised 
at SR10. You can see a full list of manuals available at SR10 FCS date by entering 
help manuals in an Aegis shell or man manuals in a UNIX shell, (man manuals 
does not work at beta.) 



Domain/OS Documentation Changes at SR10 




SR10 Manual 


SR 10 Part 
Number 


Corresponding Pre- 
SR10 Manual 


Pre-SRIO Part 
Number 


Making the Transition to 
SR 10 Operating System 
Releases 


011435-A00 


Making the Transition to 
SR9.5 


009492 


Installing Software with 
Apollo’s Release and 
Installation Tools 


008860-A00 


Installing Domain 
Software 


008860, Rev 01 


Getting Started with 
Domain/OS 


002348-A00 


Getting Started with your 
Domain System 
Getting Started with your 
Domain/IX System 


002348, Rev 04 
008017, Rev 01 


Domain Display 
Manager Command 
Reference 


0114I8-A00 


Domain System Com- 
mand Reference 


002547, Rev 01 


Domain Documentation 
Master Index 
Domain Documentation 
Quick Reference 


011242-A00 

002685-A00 


Technical Publications 
Overview 


002685, Rev 07 


Using TCP/IP Network 
Applications 


011021-A00 


Using ftp and telnet 


008867, Rev 00 


Using Your Aegis 
Environment 


O11021-A00 


Domain System User’s 
Guide 


005488, Rev 01 


Aegis Command 
Reference 


002547- A00 


Domain System Com- 
mand Reference 


002547, Rev 04 


Aegis Utilities Reference 


00941 4- A00 


Domain System Utilities 
Reference 


009414, Rev 04 


Using Your BSD 
Environment 


011020-A00 


Domain/IX System 
User’s Guide 


005803, Rev 00 


BSD Command 
Reference 


005800-A00 


Domain/IX Command 
Reference for BSD4.2 


005800, Rev 04 


Using Your SysV 
Environment 


01 1022-A00 


Domain/IX System 
User’s Guide 


005803, Rev 00 
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Domain/OS Documentation Changes at SR10 



SR10 Manual 


SRIO Part 
Number 


Corresponding Pre- 
SR10 Manual 


Pre-SRIO Part 
Number 


SysV Command 
Reference 


005798-A00 


Domain/IX Command 
Reference for BSD4.2 


005798, Rev 01 


UNIX Text Processing 


011018-A00 


Domain/IX Text Proces- 
sing Guide 

Domain/IX Text Editors 
Quick Reference 


005802, Rev 01 
005804, Rev 01 


Managing Aegis System 
Software 


010852-A00 


Administering Your 
Domain System 


001746, Rev 06 


Managing BSD System 
Software 


0 10853- A00 


System Administration 
for Domain/IX BSD4.2 


009355, Rev 00 


Managing SysV System 
Software 


010851-A00 


System Administration 
for Domain/IX SysV 


009356, Rev 00 


Managing Domain 
Routing and Domain/OS 
in an Internet 


005694-A00 


Managing the Domain 
Environment in an Inter- 
net 


005694, Rev 01 


Planning Domain 
Networks and Internets 


00991 6- A00 


Planning Domain 
Networks and Internets 


009916, Rev 00 


Managing the NCS 
Location Broker 


011895-A00 


New at SR10 


N/A 


Configuring and Mana- 
ging TCP/IP 


008543-A00 


Configuring and Mana- 
ging TCP/IP 


008543, Rev 01 


Making the Transition to 
SR10 TCP/IP 


011717-A00 


New at SR10 


N/A 


Domain/OS Call 
Reference 


007196-A00 


Domain System Call 
Reference 


007196, Rev 01 


Programming with 
Domain/OS Calls 


005506- A00 


Programming with Gen- 
eral System Calls 


005506, Rev 01 


BSD Programmer’s 
Reference 


005801-A00 


Domain/IX 

Programmer’s Reference 
for BSD4.2 


005801, Rev 01 


SysV Programmer’s 
Reference 


005799-A00 


Domain/IX 

Programmer’s Reference 
for SysV 


005799, Rev 01 


Getting Started with 
SysV STREAMS 


012276-A00 


New at SR10 


N/A 


Programming with SysV 
STREAMS 


012275-A00 


New at SR10 


N/A 
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Domain/OS Documentation Changes at SR10 



SR 10 Manual 


SR10 Part 
Number 


Corresponding Pre- 
SR10 Manual 


Pre-SRIO Part 
Number 


Programming with the 
SysV Transport 


012205-A00 


New at SR 10 


N/A 


Domain/OS Program- 
ming Environment 
Reference 


011010-A00 


Domain/IX Support 
Tools Guide 

Domain Binder and 
Librarian Reference 


009413, Rev 00 
004977, Rev 02 


Domain Distributed 
Debugging Environment 
(Domain/DDE) 
Reference 


011024-A00 


Domain Language Level 
Debugger Reference 


001525, Rev 04 


Printing in the Aegis 
Environment 


011774-A00 


New at SR 10 


N/A 
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5.2 Changes to Documentation 

The test of this chapter contains information that is not currently supplied in published 
documentation and will be included in the appropriate manuals at a later date. 

5.3 UUCP Configuration Instructions 

You should do the following when configuring UUCP. These instructions are not 
inclusive, but contain Apollo-specific configuration information. 

• Tty/sio ports used by uucp must be configured to be compatible with the attached 
modem, e.g., baud rate, bits per character, parity. 

• Although /dev/siox and /dev/ttyx (where x is the port number) refer to the same 
physical port, they are handled differently. Operations on /dev/siox ignore DCD 
status while default operations on /dev/ttyx adhere to the UNIX conventions (such 
as requiring DCD to be high before completing an open of the device). The uucp 
programs open the device with the 0_NDELAY flag, which causes the open to 
return without waiting for DCD. This enables either /dev/siox or /dev/ttyx devices 
to be used for both dialing out or receiving calls. However, it is recommended that 
/dev/ttyx devices be used exclusively for uucp (including cu and tip). This enables 
device locking to function properly. 

• To monitor the tty/sio port for incoming calls, add and entry to the /etc/ttys file to 
start /etc/getty. It is recommended for the reasons stated above, that /dev/ttyx be 
used for getty. A port monitored by /etc/getty cannot be used to dialout on unless 
getty is suspended first. This can be done using a script. 

• The uucp programs look for the file, /usrAib/uucp/sitename, to determine the uucp 
sitename. This is an ascii file containing the uucp sitename and must be created by 
the system administrator. If this file does not exist, the sitename is set to the 
nodename returned by the gethostname call. 

• The login account for sites calling into the uucp site node must have its shell 
defined to be /usr/lib/uucp/uucico.real. 

• The lock directory used by the uucp programs (including cu and tip) is 
/usr/spool/locks. It is installed as a link to ‘node_data/locks on both uucp user 
nodes and uucp site nodes. Old programs that use /usr/spool/uucp for locking 
should be modified to use the new directory. 

• Some versions of uucp, including the si9.7 Domain/IX version, send the login 
sequence with even parity by default. The srlO login program expects no parity. 

To change the parity of the login sequence sent, add the expect/send sequence of 
"" P_ZERO before the login expect/send sequence in the L.sys file. For example, 
the file could look like: 

ogin:~ogin: uucp ssword: uucp 

hammer Any ACU 9600 T555 1212 P_ZERO "" 

• Uuencode does not preserve aegis file type information. Uudecode always produ- 
ces files of type unstruct. Therefore, to transfer an obj type file, use the obty com- 
mand to change the type to unstruct. Uuencode the file, tranfer it to the destination 
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system, and uudecode it. Use the obty command to modify the type to obj. 

You should refer to Managing SysV System Software or Managing BSD System 
Software for information on UUCP. The following documents also contain helpful 
information about HoneyDanber UUCP: 

• AT&T UNIX System V User's GuideFR, Chapter 8, pp. 51-77 

• AT&T UNIX System V System Administrator's Guide , Chapter 9, pp. 1-44 

• UNIX System Security , Patrick H. Wood and Stephen G. Kochan, Hayden Books, 
Chapter 6, pp. 168-186 

• "Honey DanBer UUCP - Bringing UNIX Systems into the Information Age", Bill 
Rieken and Jim Webb, ; login:, May/June 1986, pp. 27-36 and ; login:, July/August 
1986, pp. 10-35 

5.4 Undocumented GPR Features 

This section describes GPR features that were added at SR9.7 but have not yet been 
incorporated into the two GPR manuals, Domain Graphics Primitives Resource Call 
Reference (Order No. 007194) and Programming with Domain Graphics Primitives 
(Order No. 005808). These features include eight new subroutine calls and support for 
the Domain Dial Box. 

5.4.1 New GPR Subroutine Calls 

The following new calls were added to GPR at SR9.7. They will be added to the next 
release of the GPR manuals: 

• gpr_$inq_background 

• gpr_$inq_blank_timeout 

• gpr_$inq_event_data 

• gpr_$inq_foreground 

• gpr_$inq_plane_mask_32 

• gpr_$set_blank_timeout 

• gpr_$set_raster_op_mask 

• gpr_$make_bitmap_from_array 

The data types used with these calls are existing types described in Domain Graphics 
Primitives Resource Call Reference or Domain/OS Call Reference. Any new data 
types are simple extensions of existing types. For example, the gpr_$mask_3 2_t type 
is a set with 32 elements. C and FORTRAN programmers should use 4-byte integers 
rather than 2-byte integers to store the elements of this set: 

• Gpr_$inq_background is a function that returns the background color of the win- 
dow open to the current process. The background color is returned in 
gpr_$pixel_value_t format. This is a 4-byte integer. This function can be used in 
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only direct and frame modes. It returns the following error if it is used in borrow 
mode: no such rectangle property key (graphics/rectangle manager). 

• Gpr_$inq_blank_timeout returns the time period that the display manager waits 
before it shuts off the screen following the last input event. This routine is similar 
to the shell command scrto. The time period is returned in the timeout parameter. 
The data type for this parameter is listed in /sys/ins/base.ins.pas. This data type is 
described in detail in the DomainfOS Call Reference. 

• Gpr_$inq_foreground is a function that returns the foreground color of the win- 
dow open to the current process. The foreground color is returned in 
gpr_$pixel_value_t format. This is a 4-byte integer. This function can be used in 
only direct and frame modes. It returns the following error if it is used borrow 
mode: no such rectangle property key (graphics/rectangle manager). 

• Gpr_$inq_plane_mask_32 returns the plane mask for the current bitmap. Mask, in 
gpr_$mask_3 2_t format, is the current mask. This is a set with up to 32 elements. 
Use gsr_$set_plane_mask_32 to set a plane mask. 

• Gpr_$set_blank_timeout establishes the time period that the system waits before 
it shuts off the screen. The time period is measured from the last input event. This 
routine is similar to the shell command scrto [n]. Set the time period with the 
timeout parameter. The data type for this parameter is time_$clock_t, which is 
listed in /sys/ins/base.ins.pas. This data type is described in detail in the 
DomainlOS Call Reference. 

• Gpr_$set_raster_op_mask provides a way to set raster operations on several 
planes with just one call. Pl_mask, in gpr_$mask_32_t format, establishes the plane 
mask. This is a set with up to 32 elements. Op, in gpr_$raster_op_t format, esta- 
blishes the raster operation. This is a 2-byte integer. The raster operations esta- 
blished with this call affect only the primitives currently specified with 
gpr_$raster_op_prim_set. 

• Gpr_$mq_event_data returns the time that an event occurred, and, if the event is 
a dial event, the dial number and the dial value. The dial number and dial value 
are returned in gpr_$event_data_t format. The two input parameters are event_type 
and length. Event_type is the type of event in gpr_$event_t format. 

Length is the size in bytes of event_data parameter. The output parameters are 
event_data, length_ret, time_stamp and sts. Event_data is the data structure (variant 
record) used to return the event data. FORTRAN programmers may implement this 
data type by declaring a two element array of 4-byte integers. The first element is 
the dial number, and the second element is the dial value. 

Length_ret is the number of bytes returned by the call. Time_stamp is the time that 

) the event occurred in time_$clock_t format. This data type is described in detail in 
Programming with DomainlOS Calls. Sts is the status parameter. 

• Gpr_$make_bitmap_from_array provides a way to generate a bitmap from an 
array. The bitmap is stored in main memory in external bitmap file format. This 
feature enables BLT operations to be performed with the new bitmap, which is 
advantageous if read/write pixel operations done with arrays is limiting. 
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To deallocate this type of bitmap, use gpr_$deallocate_bitmap. Since this type of 
bitmap resides in main memory, it would also be deallocated upon calling 
gpr_$terminate. 

{ Bgpr_$make_bitmap_firom_array is used to create a bitmap descriptor 
pointing to a given memory address (containing the image data). ) 

PROCEDURE gpr_$make_bitmap_from_array ( 

IN size : gpr_$offset_t; { X,Y size of bitmap } 

IN attribs : gpr_$attribute_desc_t; { Attributes bitmap is to have } 

IN groups : integer; { Number of groups } 

IN OUT g_headers : gpr_$bmf_group_header_array_t; 

{ Group headers } 

OUT bitmap : gpr_$bitmap_desc_t; { Returned bitmap descriptor } 

OUT status : status_$t { Returned status } 

); EXTERN; 

5.4.2 Support for the Domain Dial Box 

The dial box is an interactive graphics input device that allows the user to dynamically 
manipulate various display parameters with GPR and 2D GMR applications. GTCO 
Nomad and Apollo died boxes are both supported. The dial box enhances the capabili- 
ties provided by a mouse or digitizing tablet. When used with customer applications 
and Apollo dial device utilities, the dial box provides precise zoom, pan, 3D-rotation, 
and other user-selectable graphics capabilities. 

Dial Server 

The dial server allows for dial device data to be integrated into the GPR input environ- 
ment. This data is then available for GPR, 2DGMR, and Domain/Dialogue applica- 
tions. For Domain/Dialogue dial box information see the online release notes 
/install/doc/apollo/dialog.v2.01 that are available with this release. For 2DGMR infor- 
mation see the Programming with Domain 2S Graphics Metafile Resources (Order 
number 5097-A00) manual. 

The dial box server is a process that waits for data from dial boxes connected to SIO 
ports. It also waits for command requests from a mailbox. 

The server passes dial box data to processes that have enabled input for dial boxes via 
GPR functions. 

Dial requests (commands) are used for initializing a dial box on an SIO port and 
closing/releasing an SIO port. These requests are passed to the server through the 
mailbox. 

You may connect up to three dial boxes to a node. When multiple boxes are connec- 
ted, they may be distinguished by the dial numbers that are assigned when the box is 
initialized. 

Starting the Dial Server and Sending Requests 
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To start the dial server, execute the following Display Manager command: 
cps /sys/dial_server -n dial_server 

After the dial box process is started, you must initialize each dial box. Use the fol- 
lowing shell command to initialize a dial box: 

/usr/apolIo/bin/dial_server_request [-Init port<p>] [-First_dial <n> (optional)] 

Possible port numbers arc 1, 2, and 3 depending on the number of SIO ports on the 
node. First_dial is the number assigned to the first dial. The default first dial number 
is 1. 

The dials on the GTCO box are numbered sequentially as follows. 
first_dial first_dial + 1 first_dial + 2 

first_dial + 3 first_dial + 4 first_dial + 5 

first_dial + 6 first_dial + 7 first_dial + 8 

The dials on the Apollo Dial Box are numbered sequentially as follows: 

first_dial first_dial + 4 

first_dial + 1 first_dial + 5 

first_dial + 2 first_dial + 6 



first_dial + 3 first_dial + 7 

Dial numbers may range from 1 to 99, and you can assign the first dial of any dial box 
to any number in that range. When you initialize a dial box, include the first dial 
argument, or the first dial will be dial 1. This occurs with every box that you initial- 
ize. If you initialize three boxes without explicitly setting the first dial number, all the 
boxes will have the first dial as dial 1. In this case, you will not be able to distinguish 
input among the boxes. 

If you use two dial boxes, the following shell commands initialize the first box on Port 
1, with the knobs numbered from 1 to 9, and the second box initialized on Port 3 with 
the knobs numbered from 20 to 29. In this case, you can distinguish what box produ- 
ced the input by the dial numbers: 

/usr/apollo/bin/dial_server_request -init port I -first_dial 1 
/usr/apollo/bin/dial_server_request -init port3 -first_dial 20 

Provided that your request is accepted, the following messages are displayed: 

»Server Response: ....Request Accepted: Initialize Port 1, First dial = 1.. 

»Server Response: ....Request Accepted: Initialize Port 3, First dial = 20.. 

If the server is not running, the following error message is displayed: 
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***Could not open up mailbox channel*** 

Other errors, such as port contention/inaccessibility problems with the dial box, the 
cables, or the request itself, are indicated by one of the following error messages: 

»Server Response: ....Request Failed: Box not connected or dead box.... 

»Server Response: ....Request Error: Port not available.... 

»Server Response: ....Request Error: Could not open port.... 

Closing an SIO Port 

To close an SIO port, use the following request: 

/usr/apollo/bin/dial_server_request [-close port <p>] 

For example, to dose SIO Port 1, enter the following command: 

/usr/apoIIo/bin/dial_server_request -close portl 

Provided that your request is accepted, the following message is displayed: 

»Server Response: ....Request Accepted: Close Port 1.... 

Using Dial Boxes with GPR 

To enable GPR to recognize dial events, use gpr_$enable_input. A new event type, 
gpr_$dial, has been added to the gpr_$event_t data type for this purpose. 

Use gpr_$event_wait or gpr_$cond_event_wait to wait for dial events. If the event 
was a dial event, gpr_$inq_event_data, a new GPR call, returns the dial number and 
the dial value. The dial number identifies the dial, and the dial value indicates the 
amount that the knob was turned. 

Testing the Dial Box 

The dial box verification procedures are included in the /systest directory. The tests 
include dial_driver_test and dial_server_test. 

Dial_driver_test allows you to check dial box functionality without initializing the dial 
server. Dial_server_test allows you to test the box with the server initialized (use the 
initialization command described above). The tests return positive integers when a dial 
is turned to the right and negative integers when a dial is turned to the left. The tests 
also specify the dial being used. To ran the tests, enter the /systest directory and type: 

dial_server_test <RETURN> 
diaLdriver_test <RETURN> 

Dial Box Startup Scripts 

All the SR 10 startup scripts include a commented command to start up the dial server. 
Instructions in the file direct you to uncomment this command if you want the server 
to start automatically. 
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Dial Box Example 

The following Pascal fragment shows how to enable and accept input from a dial box: 
gpr_$enable_input(gpr_$dial, keys, st); 

IF(st.all o 0) THEN writeln(’ gpr_$dial could not be enabled!’); 

REPEAT 

discard(gpr_$event_wait(ev_type, ev_char, ev_pos, st)); 

IF(st.all o 0) THEN writeln(’GPR_$inq_event_data failed - retlen = *, 

retlen, ’status = ’, stall); 

IF(ev_type = gpr_$dial) THEN 
BEGIN 

gpr_$inq_event_data(ev_type, sizeof(ev_data), ev_data, retlen, time, st); 

IF(st.all o 0) THEN writeln(’GPR_$inq_event_data failed - retlen = ’, retlen, 

’status = stall) 

ELSE writeln(’GPR Event: dial#:’, ev_data.dial_number, ’ dial value = ’, 
ev_data.dial_value); 

END; 

UNTIL (count > 1); 
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Appendix 1: Changes to Commands and Calls 

This appendix lists the commands and calls that have been added, changed, and 
deleted since SR9.7. 

A. I Changes to Commands 

The following subsections list new, changed, and obsoleted commands since SR9.7. 

A. 1.1 DM Commands 

The DM log-in command no longer accepts the -h or -p options. 

A. 1.2 Commands in /com 

The following subsections describe changes to the Aegis commands that are located in 
the /com directory. As of SR 10, several commands in the /com directory are simply 
links to files in either the /usr/apollo/bin or etc directory. See the sections on these 
directories for more details. 

A. 1.2.1 Obsolete Commands 

The following commands and utilities are no longer supported as of SR 10, or will not 
be supported in future releases: 



aqdev 


The aqdev command is supplied in the /com directory at SR 10 for 
changeover compatibility reasons only. See the GPIO release notes 
for more details. 


bind_sr9.2 


Development of software for pre-SR9.5 systems is not supported at 
SR10 


cmacct 


Replaced by the edrgy utility 


cmppo 


Replaced by the edrgy utility 


crrgy 


Replaced by the rgy_create installation utility 


crucr 


Replaced by the mkapr command 


debug 


Replaced by the dde utility 


edacct 


Replaced by the edrgy utility 


edppo 


Replaced by the edrgy utility 


fppmask 


Obsoleted due to single-program-per-process support; replace with 
the fpp_$«mtrol Domain/OS call. 
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lbr_sr9.2 


Development of software for pre-SR9.5 systems is not supported at 
SR10 


login 


If you do not specify the -c option, the /com/Iogin command now 
invokes the default login shell, and not necessarily the Aegis shell. 


lrgy 


Replaced by the rgy_admin utility’s Irep command 


mrgrgy 


Replaced by the rgy_merge utility 


old_edfont 


Replaced by the new edfont utility 


prfd 


Use prf -dialog 


rldev 


The rldev command is supplied in the /com directory at SR10 for 
changeover compatibility reasons only. See the GPIO release notes 
for more details. 


salrgy 


Replaced by the rgy_admin utility 


scrch 


Replaced by the /usr/apollo/scrattr command 


sh_8 


The standard Aegis shell, sh, now provides 8 -bit support 


vctl 


This command is replced by stty 


A.l.2.2 Changed Commands 


The following commands have been changed between SR9.7 and SR 10. Refer to the 
corresponding reference document or Help file for details of the new version of the 
call. 


acl 


The acl command has been changed to incorporate the SR 10 protec- 
tion mechanisms. 


crtyobj 


Several options have been added and deleted. Several options have 
been added to provide support for European languages and time/date 
formats 


edacl 


The edacl command has been changed to incorporate the SR 10 pro- 
tection mechanisms. 


lusr 


The -me option is now the default and a new -allnodes switch has 
been added. 


nd 


The nd command is now built in to the Aegis shell; /com/nd is a 
shell script. As a result, programs that pgm_$ invoke /com/wd or 
/com/nd will no longer work - they will have to use the appropriate 
system calls instead. 


sigp 


Any process with an id that has p rights on the 
‘node_data/node_owners file of the node where the process execu- 
tes can signal any process on. the node. Otherwise, the process can 
only signal processes with the same SID. 
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tb The tb command has been extended. It now reads the process dump 

file for tracebacks of dead processes, and includes all functionality 
that was previously provided by the /systest/ssr_util/fmpd program. 
The available options have been changed and expanded, the -args 
option is no longer supported, (/com/tb is a link to /usr/apollo/tb.) 

wbak The /wbak command takes a new argument, -presrlO allows you to 

make a tape on srlO that is readable on an SR9 system by the stan- 
dard pre-SRIO rbak. There are separate /com/wbak and 
/usr/apollo/bin/wbak commands with different interfaces. 

A. 1.2.3 New Commands 

The following commands are new as of SR 10: 

cvtname Tool for conversion between SR9.7 and SR 10 case representation. 

This command is in /com only at Beta. It will be installed in the 
/sr9.7_compatibility/compat_with_sr9.7 directory at FCS. 

dde A new language level debugger which replaces the debug tool 

(/com/dde is a link to /usr/apollo/dde.) 

1st Lists information about a storage tree 

A. 1.3 Commands in /usr/apollo/bin 

The /usr/apollo directory contains Domain/OS commands that are useful in all 
environments. The following commands, servers, files, and utilities are also available 
through the /com directory or are new as of SR 10 and are specific to Domain/OS. 

The commands in the following list that were in the /com directory in previous 
releases are still available in that directory; however, many are now links to these files. 
In cases where the /com command expands derived wild cards there are different ver- 
sions of the command in the com and usr/apollo directory, and the version in 
/usr/apollo/bin directory conforms to UNIX syntax conventions and does not expand 
wildcards. Commands in /usr/apollo/bin that are new at SR10 are not available 
through the com directory 

bldt Displays the time at which the operating system was built (bldt(l)) 

chad Changes the access control list, intended for UNIX users; new at 

SR10 (chacl(l)) 

cpacl Copys the access control list, intended for UNIX users; new at SR 10 

(cpacl(l)) 

cpscr Copys the current display to a file (cpscr(l)) 

crddf Creates, displays or modifies a Device Descriptor File (crddf(l)) 

crp Creatse a remote process; Note: you If you use crp in a UNIX 

shell and include a command line in the crp invokation, you must 
quote any wild cards that you include in the command line, (crp(l)) 
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crpad Creates a transcript pad and window (crpad(l» 

city Creates a new type (crty(l» 

dbacl Domain/Dialogue based tool for changing protections 

dde High-level debugger; new at SR 10 (dde(l)) 

dial_server_request Initializes a dial box (iai_server__request(l» 
dlty Deletes a type (dlty(l)) 

edfont Edits a character font; revised at SR 10 to edit 8-bit fonts; 

(edfont(l)) 



edmtdesc 

emt 

esa 

french_to_iso 

fst 

german_to_iso 

intm 

inty 

kbm 

las 

lbr2ar 

lcm 

llib 

llkob 

lsacl 

ity 

mkapr 



Edits a magnetic tape descriptor file (edmtdesc)) 

Emulates a dumb terminal (emt)) 

Displays the address of external symbol (esa)) 

Converts an old-format French font to an 8 -bit ISO standard font 
format; new at SR 10 (french_to_iso) 

Prints fault status information; at SR10 this command is only useful 
if the INPROCESS variable is set and all commands are run in- 
process. In all other cases, the tb command provides the information 
formerly provided by fst. (fst( 1)) 

Converts an old-format German font to an 8-bit ISO standard font 
format; new at SR10 (german_to_iso) 

Installs a type manager (intm(l)) 

Installs a type 

Displays the keyboard characteristics and sets the key assignments 
for the compose, long_shift, and short_shift functions; new at SR 10 
(german_to_iso) (inty(l)) 

Lists objects mapped into the address space (las(l)) 

Converts an Aegis obj Ibr library format file to UNIX COFF ar 
archive format; new at SR 10 

Loads a color map (lcm(l)) 

Lists installed libraries (llib(l)) 

Lists locked objects (llkob(l)) 

Lists the access control list, intended for UNIX users; new at SR 10 

(Isacl(l)) 

Lists installed types (lty(l)) 

Creates an Apollo Product Report; new at SR 10 
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mksinit 

mt 

nor.dan_to_iso 

obj2coff 

prf 

rbak 

rwmt 

scrattr 

scrto 

stcode 

strinfo 

swedish_to_iso 

swiss_to_iso 

systype 

tb 

tpm 

trconf 

trmon 

ts 



Make a SysV STREAMS initialization file from a master.d file; new 
at SR10 

The BSD mt program 

Converts an old-format Norwegian/Danish font to an 8-bit ISO stan- 
dard font format; new at SR 10 (nor.dan_to_iso) 

Converts obj format binaries (produced by pre-SRIO compilers) to 
COFF format; new at SR 10 

Queues a file for printing; there are separate /com/prf and 
/usr/apollo/bin/prf commands with different interfaces. (prf(l» 

Restores a backup file that was generated by wbak (rbak(l)) 

Reads or writes magnetic tapes; there are separate /com/rwmt and 
/usr/apollo/bin/rwmt commands with different interfaces. 

(rwmt(l)) 

Shows screen attributes, provides the same information provided in 
previous releases by /com/scrch; new at SR 10 (scrattr(l)) 

Sets the screen time-out for display blanking (scrto(l)) 

Translates the status code value to a text message (stcode(l)) 

Print information about currently running (SysV) Streams; hew at 
SR 10 (strinfo(l)) 

Converts an old-format Swedish font to an 8-bit ISO standard font 
format; new at SR10 (Swedish_to_iso) 

Converts an old-format Swiss font to an 8-bit ISO standard font for- 
mat; new at SR 10 (swiss_to_iso) 

Displays a file’s UNIX version stamp; was in /etc in previous 
releases (systype) 

Traces back a program after a fault; this command has been exten- 
ded. It now reads the process dump file for tracebacks of dead pro- 
cesses, and includes all functionality that was previously provided by 
the /systest/ssr_util/fmpd program. It also provides information pre- 
viously provided by the fst command. The avialable options have 
been changed and expanded. 

Sets the mouse or touchpad mode (tpm(l)) 

Configure a (SysV) Stream with trace modules; new at SR 10 

Monitor a Stream with trace modules after configuration; new at 
SR10 

Displays the module name and time stamp stored in an Apollo 
object module; previously in /systest/ssr_util 
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tz Sets or displays the system time zone (tz(l)) 

uk_to_iso Converts an old-format UK font to an 8-bit ISO standard font for- 

mat; new at SR10 

wbak Writes a backup tape; there are separate /com/wbak and 

/usr/apollo/bin/wbak commands with different interfaces. The /wbak 
command takes a new argument, -presrlO allows you to make a 
tape on srlO that is readable on an SR9 system by the standard pre- 
SR10 rbak. (wbak(l)) 

vsize Sets or displays VT100 window settings (vsize(l)) 

vtlOO VT100 terminal emulator (vt 100(1)) 

xdmc Executes a display manager command (xdmc(l)) 

A. 1.4 Domain Extensions to /etc 

The etc directory now contains Domain/OS administrative commands and files and is 
common to all three environments. The following commands, servers, files, and utili- 
ties were previously located in either the /com directory or the Vsys directory on both 
Aegis and Domain/IX systems, or are new as of SR10 and are specific to Domain/OS. 

The commands in the following list that were in the /com directory in previous 
releases are still available in that directory; however, many are now are links to these 
files. In cases where the /com command expands derived wild cards there may be 
different versions of the command in the com and etc directories with different seman- 
tics. Some items in the following list are links to entries in the /‘node_data/etc direc- 
tory. 

chuvol Changes the UID of a volume 

copyright A file containing copyright statememts that are displayed by /etc/rc 

cpboot Copies the system boot file 

crpty Create a pseudo-tty 

ctnode Catalogs a node; there are separate /com/ctnode and 

/usr/apollo/bin/ctnode commands with different interfaces 

daemons A directory of files that control the daemons started by etc/rc; a link 

to k node_data/etc/daemons; new at SR 10 

dm_or_spm Starts the DM or SPM process, depending upon whether the system 
has a display; new at srlO 

dmmsg A file containing the message displayed in the DM output window 

on login; new at SR10 

drm_admin Data replication manager administration tool; formerly in /sys/ncs 
/etc/ncs/drm_admin 
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edns 


Edits the ns_helper database 


edrgy 


Edits the registry database; new at SR10 


environ 


A file that specifies the default values of the SYSTYPE and 
ENVIRONMENT variables for the node. 


environment 


Displays the current environment and installed environments (This 
command is not available at Beta) 


find_orphans 


Finds uncataloged objects; The /etc/find_orphans command has 
been changed so that it can now take a list of orphans that is genera- 
ted by salvol and catalogs the objects. It should be mn each time 
you boot a node; the /etc/rc template now includes this procedure. 


glbd 


Global location broker daemon (/etc/ncs/glbd); formerly in /sys/ncs 


group 


Group file information; this is now a read-only file provided through 
the extensible streams mechanism 


import_passwd 


Imports the contents of standard UNIX /etc/passwd and /etcgroup 
files into the registry 


invoke_script 


Invokes one of two scripts, an Aegis shell script or a Bourne shell 
script, that are specified as input arguments, depending upon the 
environment(s) installed on the system. 


invol 


Initializes a disk volume; the invol utility has been rewritten at SR10 


lb_admin 


Location broker administration tool; formerly in /sys/ncs; 
(/etc/ncs/I b_ad min ) 


lcnet 


Lists connected networks 


lcnode 


Lists connected nodes 


llbd 


Local location broker daemon; formerly in /sys/ncs (/etc/ncs/llbd) 


login_log.conf 


This file (a link to k node_data/etc/loginjog.conf) is used to specify 
which login-related events should be logged and, optionally, the 
name of the log file. 


lprotect 


Protects the local node from remote root access; new at SR 10 


magic 


New at SR 10 


mkdevno 


Creates a device number; new at SR 10 


netmain 


Network statistics tool 


netmain_chklog 


Cleans up bad netmain log files 


netmain_note 


Places a message in the network error log 


netmain_srvr 


Network statistics server; formerly in /svs/net 


netsvc 


Sets or displays network services 
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nodestat 

obty 

org 



passwd 

probenet 

rgy_admin 

rgy_merge 

rgyd 

rtchk 

rtstat 

rtsvc 

salad 

salvol 

server 

show_lc 

shutspm 

syncids 

sys.conf 

sys_sh 

templates 

uctnode 
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Displays node statistics; /com/netstat is now a link to this file 

Sets or displays the type of an object; there are separate /com/obty 
and /usr/apollo/bin/obty commands with different interfaces 

Provides information about organization members, similar to the 
group file; it is provided through the extensible streams mechanism. 
The entry for a single organization can span multiple lines; in this 
case each line but the last is terminated by an escaped newline. New 
at SR10 

Passwd file information; this is now a read-only file provided 
through the extensible streams mechanism 

Probes the network and displays error statistics 

Registry administration tool; new at SR 10 

Tool for merging registries; new at SR10 

Registry daemon; new at SR 10 

Tests traffic between adjacent routers 

Displays internet router statistics 

Sets or displays internet routing service 

Salvages an Access Control List; this utility takes a new -I option 
that lists the UIDs of the ACL files that are merged. 

Salvages a disk volume; this command has been revised at SR10, 
and now takes a set of command line arguments when run from a 
shell 

Runs the program or command specified by its arguments, by default 
with process id user.server.none; new at SR10. 

A compatibility tool which shows which obsolete system calls are 
being made by an object module; new at SR 10 

Shuts down SPM on a node 

Synchronizes UNIX user IDs on disk to the definitions in the regis- 
try to ensure consistency; this command should only be necessary in 
extraordinary circumstances; new at SR10 

Global library configuration file, a link to ‘node_data/etc/sys.conf; 
new 

The shell executed by init to interpret /etc/rc; new at SR 10 

A directory containing template configuration files, such as a tem- 
plate /etc/rc 

Uncatalogs a node; there are separate versions of the uctnode com- 
mand in the com and /usr/apollo/bin directories with different 
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interfaces. 

uctob Uncatalogs an object; there are separate versions of the uctob com- 

mand in the com and /usr/apollo/bin directories with different inter- 
faces. 

ulkob Unlocks an object; there are separate versions of the ulkob com- 

mand in the com and /usr/apollo/bin directories with different inter- 
faces. 

uukLgen Generates an ASCII UUID (Universal Unique Identifier) 

(/etc/ncs/uuid_gen) 

A.1.5 TCP/IP Support 

At SR10, all three environments include the BSD version of TCP/IP communications 
protocol support. Each environment also provides a set of tools and utilities that use 
TCP/IP as an underlying communications protocol. The following sections list the 
commands and files provided for TCP/IP support. For more information on these facil- 
ities, see the TCP/IP documentation. 

A. 1.5.1 Administrative Facilities Files in /etc 

The following facilities and files are common to all three environments and have been 
put in the /etc directory. Note that the section numbers follow the SysV section num- 
bering scheme. See Making the Transition to SR10 TCPIIP for information on changes 
between the previous release of Domain/IX BSD TCP/IP and SR10 TCP/IP. 

arp (arp(lrn)) 

dtcb Dump TCP control block program; a debugging tool (dctb(l)) 

ftpd (ftpd(lm)) 

gateways This file contains information about routing gateways (gateways(4)) 

gettable (gettable(lm)) 

hostns Maps /etc/hosts to /etc/named (hostns(lm)) 

hosts (hosts(4» 

hosts.equiv Specifies equivalent hosts for login purposes (hosts.equiv(4)) 

hostname (hostname( 1 )) 

htable (htable(lm)) 

ifconfig (ifconfig(lm)) 

inetd (inetd(lm)) 

inetd.conf (inetd.conf(4)) 

mbd Memory buffer dump; a troubleshooting utility (mbd(l)) 
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mkhosts 

named 

named.boot 

named. ca 

named.hosts 

named.local 

named.rev 

networks 

nshost 

ping 

protocols 

resolv.conf 

rexecd 

rlogind 

route 

routed 

rshd 

rwhod 

services 

syslogd 

tcpd 

telnetd 

tftpd 

trpt 



(mkhosts(lm)) 

(named(lm)) 

(named.boot(4)) 

(named.ca(4)) 

(named. hosts(4)) 

(named. local(4)) 

(named.rev(4)) 

(networks(4)) 

Maps /etc/named to /etc/hosts (nshost(lm)) 

(ping(lm)) 

(protocols(4)) 

Contains information used by named (resolv.conf(4)) 

(rexecd(lm)) 

I ■ 

(rlogind(lm)) 

(route(lm)) 

(routed(lm)) 

(rshd(lm)) 

(rwhod(lm)) 

(services(4)) 

(syslogd(lm)) 

Replaces tcp_server used by pre-srlO Aegis TCP/IP (tcpd(lm)) 
(telnetd(lm)) 

An adaptation of the MIT Project Athena implementation of the tftp 
protocol (tftpd(lm)) 

TCP remote packet trace utility; a debugging tool ( trpt(lm)) 



A. 1.5.2 SysV TCP/IP Commands and Files 

The following TCP/IP commands are supported in the SysV environment in the 
/usr/bin directory 

ftp (ftp(lc)) 

logger (Iogger( 1)) 

netstat (netstat(l)) 
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rlogin 


(rlogin(lc)) 


remsh 


The BSD rsh utility (remsh(lc)) 


ruptime 


(ruptime(lc)) 


rwho 


(rwho(lc)) 


telnet 


(telnet(lc)) 


tftp 


An adaptation of the MTT Project Athena implementation of the tftp 
protocol (tftp(lc)) 


whois 


(whois(l)) 



A. 1.5.3 Aegis TCP/IP Commands and Utilities 

The following TCP/IP commands are supported in the Aegis environment in the /com 
directory 

ftp 

tcpstat The BSD netstat command 

telnet 

A. 1.6 S ys V Commands 

The following sections list commands that run in the SysV environment that are 
obsolete, changed, or added as of SR 10. It includes commands added to support 
AT&T System V Release 3 UNIX. 

A. 1.6. 1 Obsolete or Unsupported Commands 

As of SR 10 all SysV text formatting facilities are part of The Documentors Work- 
bench optional layered product. Therefore the following commands are no longer pro- 
vided as part of the base software: nroff, troff, eqn, neqn, tbl, mm, mmt, checkmm, 
mvt, cm, ptx, diffmk, hyphen. 

Due to export restrictions we do not support the following commands: xsend, xget, 
enroll, crypt, makekey. 

The following commands are no longer supported in SR 10: 

addroot Obsoleted by changes to the protection mechanism (addroot(lm)) 

crpasswd Obsoleted by changes to the registry (crpasswd(lm)) 

cvtumap Conversion from SR8 naming is not supported by SR 10 

(cvtumap(lm)) 

fix_cache Obsoleted by changes to the protection mechanism (fix_cache(lm)) 

flush_cache Obsoleted by changes to the protection mechanism 

(flush_cache(lm)) 
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mkptnr netman now performs all functions that were done by this command 

(mkptnr(lm)) 

sup Obsoleted by changes to the protection mechanism (sup(lm)) 

update_slave Obsoleted by changes to the registry system (update_slave(lm» 

A. 1.6.2 Changed Commands 

The following commands were significantly changed between SR9.7 and SR 10: 

cp This command has several added options and extensions. (cp(l» 

cpio This command can now handle typed files, (cpio(l)) 

date This command can now set the date. The software system date and 

time is changed immediately, but the hardware clock (used to gen- 
erate Domain UIDS) is actually updated when the node reboots. 
(date(l)) 

Id The Id loader no longer invokes /com/bind, but is a separate utility. 

Ld now folows full UNIX semantics; as a result, archives must now 
be the final argument to the command. Ld can now mark object 
modules to be run with a non-default stack si/e. (Id(l» 

Is The Is command takes a new option, -T that causes it to display the 

types of all objects. (Is(l)) (mkdir(l)) 

mkdir The SysV mkdir command also now accepts the System V Release 

3 -tn and -p options, (mkdir(l)) 

ps The ps command can now display process status information for 

remote nodes. (ps(l )) 

tar This command can now handle typed files, (tar(l)) 

time The time command now splits cpu time up evenly into system time 

and user time. Previously it reported all cpu time as user time. 
(time(l)) 

A.l.6.3 New Commands 

The following commands are supported in SR 10 SysV that were not previously sup- 
ported or are new with System V Release 3. This list includes BSD commands suppor- 
ted by SysV, but does not include the Apollo extensions in /etc and /usr/apollo/bin 

300 (300(1)) 

450 (450(1)) 

captoinfo (captoinfo(lm)) 

clone Open any minor device on a SysV STREAMS driver (cione(7)) 
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dump 


(dump(l)) 


f77 


(f77(l)) 


gencc 


(gencc(lm)) 


getopt 


(getopt(l)) 


getty 


The SysV environment uses the 4.3BSD version of this command 
(/etc/getty(lm)) 


glossary 


(glossary(l)) 


greek 


(greek(l)) 


infocmp 


(infocmp(lm)) 


init 


The SysV environment uses the 4.3BSD version of this command 
(/etc/init(lm)) 


ksh 


(ksh(l)) 


list 


(list(l)) 


locate 


(locate(l)) 


log 


(log(7)) 


mcs 


(mcs(l)) 


mkdev 


The SysV mkdev command takes options to create Apollo-specific 
devices. (/etc/mkdev(lm)) 


mkinit 


(mkinit(lm)) 


mknod 


(/etc/mknod(lm)) 


mt 


The SysV environment now supports the BSD version of the mt 
utility. (mt(7)) 


ports 


(ports(7)) 


prof 


(prof(l)) 


prtconf 


(prtconf(lm)) 


sa 


(sa(7)) 


sendmail 


The SysV environment now supports the BSD version of sendmail. 
(sa(lm)) 


starter 


(starter(l)) 


strace 


(strace(lm)) 


strclean 


(strclean(lm)) 


streamd 


(streamd(lm)) 


strerr 


(strerr(lm)) 
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suid_exec 


(suid_exec(lm)) 


sxt 


(/dev/sxt(7» 


syncids 


(syncids(lm)) 


timex 


(timex(l)) 


usage 


(usage(l)) 


uucheck 


(uucheck(lm)) 


uucico 


(uucico(lm)) 


uu cleanup 


(uucleanup(lm)) 


uusched 


(uusched(lm)) 


Uutry 


(Uutry(lm)) 


uuxqt 


(uuxqt(lm)) 



A. 1.7 Changes to BSD Commands and Files 

The following subsections list commands that run in the BSD environment that are 
obsolete, changed, or added as of SR10. 



A. 1.7. 1 Obsolete or Unsupported Commands 

Due to export restrictions we do not support the crypt or makekey commands. 

The following commands are no longer supported in SR 10: 

addroot Obsoleted by changes to the protection mechanism (addroot(lm)) 

crpasswd Obsoleted by changes to the registry (crpasswd(lm)) 

cvtumap Conversion from SR8 naming is not supported by SR 10 

(cvtumap(lm)) 

eyacc Eyacc is not supported by 4.3BSD (eyacc(l)) 

fix_cache Obsoleted by changes to the protection mechanism (fix_cache(lm)) 

flush_cache Obsoleted by changes to the protection mechanism 

(flush_cache(lm)) 

mkptnr netman now performs all functions that were done by this command 

(mkptnr(lm)) 

ratfor (ratfor(l)) 

sup Obsoleted by changes to the protection mechanism (sup(lm)) 

update_slave Obsoleted by changes to the registry system (update_slave(lm)) 
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The following commands were significantly changed between SR9.7 and SR 10: 

cp This command has several added options and extensions, (cp(l)) 

date This command can now set the date. The software system date and 

time is changed immediately, but the hardware clock (used to gen- 
erate Domain DTDS) is actually updated when the node reboots. 
(date(l)) 

Id The Id loader no longer invokes /com/bind, but is a separate utility. 

Ld now folows full UNDC semantics; as a result, archives must now 
be the final argument to the command. 

printcap The installation tools now put a /etc/printcap file on each node, and 

do not create printcap as a link to an administrative node file. 
Therefore, if you use BSD printing facilities you must now recreate 
the appropriate links or administer each node’s printcap file. (The 
file format is not changed.) (/etc/printcap(8)) 

ps The ps command can now display process status information for 

remote nodes. (ps(l)) 

tar This command can now handle typed files, (tar(l)) 

time The time command now splits cpu time up evenly into system time 

and user time. Previously it reported all cpu time as user time. 
(time(l )) 

A. 1.7.3 New Commands 

The following commands programs and files are supported in the SR 10 BSD environ- 
ment and were not supported in SR9.7 and earlier Domain/IX 4.2BSD. Note that this 
list does not include SysV administrative facilities that are available in the BSD 
environment due to the common /etc directory 

ac (ac(8)) 

atq (atq(l)) 

atrm (atrm(l)) 

biff (biff(l)) 

coffdump An extended version of the SysV dump command; SR 10 does not 

support the 4.3BSD dump command, (coffdump(l)) 

compress (compress(l)) 

comsat (comsat(8c)) 

error (error(l)) 

f77 (f77(l)) 

file The BSD environment uses the System V version of the file com- 

mand. (file(l )) 
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finger 


(finger(l)) 


getty 


(Stctty(8)) 


gprof 


(gprof(l)) 


init 


(init(8)) 


ksh 


(ksh(l» 


logger 


(logger(l)) 


makedev 


(/dev/makedev(8)) 


mkdev 


The SysV mkdev command takes options to create Apollo-specific 
devices. (/etc/mkdev(8)> 


ntalkd 


The new talk daemon supplied as part of 4.3BSD (ntalkd(8» 


pdx 


(pdx(l)) 


ping 


(ping(8)) 


pix 


(pix(l)) 


pmerge 


Pascal file merger (pmerge(l)) 


prof 


(prof(l)) 


rdist 


(rdist(l)) 


reboot 


The /etc/reboot command works for all nodes except for sau2 
(DN3xx) and sau5 (DN5xx non-turbo) systems. On these systems, it 
acts as a halt command. (/etc/remote(8)) 


remote 


(/etc/remote(8)) 


sa 


(sa(8)) 


sees 


(sccs(l» 


shutdown 


(/etc/shutdown(8)) 


struct 


(struct(l)) 


sysiogd 


(syslogd(8)> 


tcopy 


(tcopy(l)) 


tftp 


An adaptation of the MIT Project Athena implementation of the tftp 
protocol (tftp(lc)) 


timed 


(timed(8)) 


trpt 


(trpt(8c)) 


vacation 


(vacation(l)) 


vgrind 


(vgrind(l)) 
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vwidth 


(vwidth(l)) 


w 


(w(l» 


whois 


(whois(l)) 


xsend 


(xsend(l)) 



A. 1.7.4 UUCP Support 

At SR 10, we support only the System V Honey DanBer version of UUCP in both the 
BSD and SysV environments. The following BSD commands have been replaced by 
their System V HoneyDanBer equivalents: 

uucico.8c 

uuclean.8c 

uucp.lc 

uucpd.8c 

uulog.lc 

uuname.lc 

uupolL8c 

uuq.lc 

uusend.lc 

uusnap.Sc 

uux.lc 

uuxqt.8c 

The following HoneyDanBer UUCP commands have been added to the BSD environ- 
ment: 

uucheck.8c 

uucleanup.8c 

uusched.Sc 

uustat.lc 

uuto.lc 

uux.lc 

A.2 Changes to Calls 

Domain/OS now supports the AT&T System V Release 3 and the 4.3 Berkeley 
Software Distribution environments, and the supported UNIX system calls conform to 
those releases. In addition, SR 10 supports many UNIX calls that were unavailable in 
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Domain/IX, and several Aegis calls have been added or changed. 

A.2.1 SysV Calls, Subroutines, and File Formats 

The following subsections list the SysV calls that are obsolete at SR 10, as well as the 
features that have been added or changed since SR9.7. 

A.2.1.1 Obsolete or Unsupported Calls 

We do not support the crypt(3x) call due to export restrictions. 

The following system calls are obsolete. Apollo does not commit to support these 
calls in future software releases. 

default_acl This call is no longer required. At SR 10 it is a noop. 

(default_acl(2» 

set_sbrk_size This call is no longer required. At SR10 it is a noop. 
(set_sbrk_size(2)) 

soft_link This call is now identical to symlink(2). Both now support soft links 

by using textual links. (soft_link(2)) 

A. 2. 1.2 New and Changed Features 

The following system calls, subroutines, file formats, and miscellaneous features are 
supported in the SR 10 SysV environment that were not in SR9.7 and earlier 
Domain/IX SysV, or are significantly changed since SR9.7. 

abort Terminates a FORTRAN program (abort(3f)) 

abs, iabs, dabs, cabs, zabs A FORTRAN absolute value (abs(3f)) 

acct Per-process accounting file format (acct(4)) 

acos, dacos FORTRAN arccosine intrinsic function (acos(3f)) (aimag(3f)) 

aint, dint FORTRAN integer part intrinsic function (aint(3f)) 

asin, dasin FORTRAN arcsine intrinsic function (asin(3f)) 

atan, datan FORTRAN arctangent intrinsic function (atan(3f)) 

atan2, datan2 FORTRAN arctangent intrinsic function (atan2(3f)) 

bool: and, or, xor, not, lshift, rshift FORTRAN bitwise Boolean functions (bool(3f» 

checklist List of file systems processed by fsck and ncheck (checklist(4)) 

conjg, dconjg FORTRAN complex conjugate intrinsic function (conjg(3f)) 

cos, dcos, ccos FORTRAN cosine intrinsic function (cos(3f)) 

cosh, dcosh FORTRAN hyperbolic cosine intrinsic function (cosh(3f)) 
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ctio Cartridge tape I/O (ctio(4)> 

dim, ddim, idim Positive difference intrinsic functions (dim(3f)) 
dirent File system independent directory entry (dirent(4)> 

dprod Double-precision product intrinsic function (dprod(3f)) 

dup2 Duplicates an open file descriptor (dup2(3c)) 

exp, dexp, cexp FORTRAN exponential intrinsic function (exp(3f)) 
filehdr File header for common object files (filehdr(4)) 

fstab File system table (fstab(4)) 

ftype: int, ifix, idint, real, float, sngl, dble, cmplx, dcmplx, ichar, char Explicit FOR- 
TRAN type conversion (ftype(3f» 

getarg Returns a FORTRAN command-line argument (getarg(3f)) 

getdents Reads directory entries and puts them in a file (getdents(2)) 

getenv Returns a FORTRAN environment variable (getenv(3f)) 

getmsg Gets the next message off a stream (getmsg(2)) 

getoid, geteoid Gets the organization identity (getoid(2)) 

getorgent, getorgid, getorgnam, setorgent, endorgent Gets the organization file entry 
(getorgent(3)) 

gettydefs The speed and terminal settings used by getty (gettydefs(4)) 

getut: getutent, getutid, getutline, pututline, setutent, endutent, utmpname Accesses a 
utmp file entry (getut(3c)) 

iargc Returns the number of command-line arguments (iargc(3f)) 

index Returns the location of a FORTRAN substring (index(3f)) 

inittab Script for the init process (inittab(4)) 

issue Issues an identification file (issue(4)) 

jagent Host control of windowing terminal (jagent(5» 

layers Protocol used between host and windowing terminal under layers(l) 

(layers(5)) 

ldahread Reads the archive header of a member of an archive file 

(ldahread(3x)) 

ldclose, ldaclose Closes a common object file (ldclose(3x)> 

ldfcn Common object file access routines (ldfcn(4)) 

ldfhread Reads the file header of a common object file (ldfhread(3x)> 

ldlread, ldlinit, ldlitem Manipulates line number entries of a common object file func- 
tion (idlread(3x)) 
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ldlseek, ldnlseek Seeks to line number entries of a section of a common object file 
(ldlseek(3x» 

ldohseek Seeks to the optional file header of a common object file 

(ldohseek(3x» 

ldopen, Idaopen Opens a common object file for reading (ldopen(3x)) 

ldrseek, ldnrseek Seeks to relocation entries of a section of a common object file 
(ldrseek(3x» 

ldsgetamame Retrieves the file name of a member of an archive file 
(Idsgetarname(3x)) 

ldsgetname Retrieves the section name for a common object file entry entry 
(ldsgetname(3x)) 

Idsgetstring Retrieves a string from the common object file string table 
(ldsgetstring(3x)) 

ldshread, ldnshread Reads an indexed/named section header of a common object file 
(Idshread(3x)> 

ldsseek, ldnsseek Seeks to an indexed/named section of a common object file 
(ldsseek(3x)) 

ldtbindex Computes the index of a symbol table entry of a common object file 

(ldtbindex(3x» 

Idtbread Reads an indexed symbol table entry of a common object file 

(Idtbread(3x)) 

ldtbseek Seeks to the symbol table of a common object file (ldtbseek(3x)) 

len Returns the length of a FORTRAN string (len(3f)) 

limits File header for implementation-specific constants (limits(4)) 

linenum Line number entries in a common object file (linenum(4)) 

lockf Record locking on files (lockf(3c)) 

log, alog, dlog, clog FORTRAN natural logarithm intrinsic function (log(3f)) 

loglO, aloglO, dlog 10 FORTRAN common logarithm intrinsic function (Iog10(3f)) 

malloc, free, realloc, calloc, mallopt, mallinfo Fast main memory allocator 
(malloc(3x)) 

master Master configuration database (master(4» 

max, maxO, amaxO, maxi, amaxl, dmaxl FORTRAN maximum-value functions 
(max(3f)) 

mclock Returns FORTRAN time accounting (mclock(3f)) 

mil: ior, iand, not, ieor, ishft, ishftc, ibits, btest, ibset, ibclr, mvbits FORTRAN Mili- 
tary Standard functions (mil(3f)) 
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min, minO, aminO, mini, aminl, dminl FORTRAN minimum-value functions 
(min(3f» 

mmap, msync, munmap, mprotect, madvise, mset, mclear Berkeley’s proposed memory 
management system calls. The implementation is based on proposals 
published by Berkely. These calls are provided in Domain/OS as 
extensions to the SysV environment. (mmap(3)> 

mod, amod, dmod FORTRAN remaindering intrinsic functions (mod(3f» 

monitor Prepares execution profile (monitor(3c)) 

nlist Gets entries from the name list (nlist(3c)) 

pnch File format for card images (pnch(4)) 

poll SysV STREAMS facility input/output multiplexing (poll(2)) 

prof Profile within a function (prof(5)) 

profil Execution time profile (profil(2)) 

putmsg Sends a message on a stream (putmsg(2)) 

rand, irand, srand Random number generator (rand(3f)) 

reloc Relocation information for a common object file (reloc(4)) 

rename Renames a file; this call now will replace the target if it is a file; at 

SR9.7, rename would not replace an existing target file. 

(rename(3f)) 

rfmaster Remote File Sharing name server master file (rfmaster(4)) 

round: anint, dnint, nint, idnint FORTRAN nearest integer functions (round(3f)) 

scnhdr Section header for a common object file (scnhdr(4)) 

scr_dump Format of curses screen image file (scr_dump(4)) 

setoid, seteoid, setroid Organization ID (setoid(3)) 

setreoid Sets the real and effective organization ID (setreoid(2)) 

sign, isign, dsign FORTRAN transfer-of-sign intrinsic function (sign(3f» 

signal Specifies FORTRAN action on receipt of a system signal 

(signal(3f)) 

sigset, sighold, sigrelse, sigignore, sigpause Signal management (sigset(2)) 
sin, dsin, csin FORTRAN sine intrinsic function (sin(3f)) 
sinh, dsinh FORTRAN hyperbolic sine intrinsic function (sinh(3f)) 
sio Serial I/O (sio(4)) 

sqit, dsqrt, csqrt FORTRAN square root intrinsic function (sqrt(3f)) 



Commands and Calls 



A-21 




statfs, fstatfs 

stdio 

stime 

strcmp: lge, lgt, 

syms 

system 

system 

t_accept 

t_alloc 

t_bind 

t_close 

t_connect 

terror 

t_free 

t_getinfo 

t_getstate 

t_listen 

t_look 

t_open 

t_optmgmt 

t_rcv 

t_rcvconnect 

t_rcvdis 

t_rcvrel 

t_rcvudata 

t_rcvuderr 

t_snd 

t_snddis 

t_sndrel 

t_sndudata 

t_sync 
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Gets file system information (statfs(2)) 

Standard buffered input/output package (stdio(3s» 

Sets the time (stime(2)) 

lie, lit String comparison intrinsic functions (strcmp(3f)) 

Common object file symbol table format (syms(4» 

Issues a shell command from FORTRAN (system(3f» 

System configuration information table (system(4)) 

Accepts a connect request (t_accept(3n)) 

Allocates a library structure (t_alIoc(3n)> 

Binds an address to a transport endpoint (t_bmd(3n)) 

Closes a transport endpoint (t_close(3n)) 

Establishes a connection with another transport user (t_connect(3n)) 
Produces an error message (t_error(3n)) 

Frees a library structure (t_free(3n)) 

Gets protocol-specific service information (t_getinfo(3n» 

Gets the current state (t_getstate(3n)) 

Listens for a connect request (t Jisten(3n)> 

Looks at the current event on a transport endpoint (t Jook(3n)) 
Establishes a transport endpoint (t_open(3n» 

Manages options for a transport endpoint (t_optmgmt(3n)) 

Receives data or expedited data sent over a connection (t_rcv(3n)) 
Receives the confirmation from a connect request (t_rcvconnect(3n)) 
Retrieves information from a disconnect request (t_rcvdis(3n)) 
Acknowledges receipt of an orderly release indication (t_rcvrel(3n)> 
Receives a data unit (t_rcvudata(3n)) 

Receives a unit data error indication (t_rcvuderr(3n)) 

Sends data or expedited data over a connection (t_snd(3n)) 

Sends a user-initiated disconnect request (t_snddis(3n)) 

Initiates an orderly release (t_sndrel(3n)) 

Sends a data unit (t_sndudata(3n» 

Synchronizes the transport library (t_sync(3n)) 
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t_unbind 
tan, dtan 
tanh, dtanh 
times 

timezone 

ttyslot 

ulimit 

umount 

unistd 

ustat 

xtproto 

putpwent 



Disables a transport endpoint (t_unbind(3n)> 

FORTRAN tangent intrinsic ftmction (tan(3f» 

FORTRAN hyperbolic tangent intrinsic function (tanh(3f)) 

The times call now reports 50% of cpu time as user time and 50% 
of cpu time as system time. It previously reported all cpu time as 
user time. (times(2)) 

Sets the default system time zone (timezone(4)) 

Finds the slot in the utmp file of the current user (ttyslot(3c)) 

Gets and sets user limits (ulivnit(2» 

Unmounts a file system (umount(2» 

File header for symbolic constants (unistd(4)) 

Gets file system statistics (ustat(2)) 

Multiplexed channels protocol used by xt(7) driver (xtproto(5)) 
Writes password file entry (putpwent(3c)) 



A.2.2 BSD System Calls, Subroutines, and File Formats 

The following subsections list the BSD calls that are obsolete at SR 10, as well as the 
features that have been added or changed since SR9.7. 

A.2.2. 1 Obsolete or Unsupported Calls 

We do not support the crypt(3) call due to export restrictions. 

The following system calls are no longer required and are obsolete. At SR 10 they are 
supplied as no-ops. Apollo does not commit to support these calls in future software 
releases. 

default_acl This call is no longer required. At SR 10 it is a noop. 
(default_acl(2)) 

set_sbrk_size This call is no longer required. At SR10 it is a noop. 
(set_sbrk_si/.e(2)) 

soft_link This call identical to symlink fR(2). both now support soft links 

by using textual links, (soft _link(2)> 



A.2.2.2 New and Changed Features 

The following system calls, subroutines, file formats, and miscellaneous features are 
supported in SR10 BSD that were not in SR9.7 and earlier Domain/IX 4.2BSD, or are 
significantly changed since SR9.7. 
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abort Abnormal termination (abort(3f)) 

access Determines the accessibility of a file (access(3f» 

acct Execution accounting file (acct(5» 

alarm Executes a subroutine after a specified time (alarm(3f)) 

asinh, acosh, atanh Inverse hyperbolic functions (asinh(3m)) 

bessel functions: jO, jl, jn, yO, yl, yn These are of two kinds for integer orders 
(bessel(3f)) 

bit The and, or, xor, not, rshift, lshift bitwise functions (bit(3f)) 

chdir Changes the default directory (chdir(3f» 

chmod Changes the mode of a file (chmod(3f)) 

cons Console interface (cons(4)) 

ctio Cartridge tape I/O (ctio(4)) 

ctime, localtime, gmtime, asctime, timezone Convert date and time to ASCII 
(ctime(3)) 

dbx The dbx symbol table information (dbx(5)) 

disktab Disk description file (disktab(5» 

dump, dumpdates Incremental dump format (dump(5)) 

erf, erfc Error functions (erf(3m)) 

etime, dtime Returns elapsed execution time (etime(3f)) 

exit Terminates process with status (exit(3f)) 

fdate Returns the date and time in an ASCII string (fdate(3f)) 

fl Console floppy interface (fl(4)) 

flmin, Umax, fffac, dflmin, dflmax, dffrac, inmax Returns extreme values (flmin(3f)) 

flush Flushes output to a logical unit (flush(3f)) 

fork Creates a copy of this process (fork(3f)) 

fseek, ftell Repositions a file on a logical unit (fseek(3f)) 

getarg, iargc Returns command line arguments (getarg(3f)) 

getc, fgetc Gets a character from a logical unit (get c(3f)) 

getcwd Gets the pathname of the current working directory (getcwd(3f)) 

getdents Reads directory entries and puts them in a file (getdents(2» 

getenv Gets the value of environment variables (getenv(3f)) 

getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent Gets a file system descriptor 
file entry (getfsent(3)) 
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getlog Gets a user’s log-in name (getlog(3f)) 

getoid, geteoid Gets the organization identity (getoid(2)) 

getopt Gets the option letter from argv (getopt(3)) 

getorgent, getorgid, getorgnam, setorgent, endorgent Gets the organization file entry 
(getorgent(3)) 

getpid Gets the process ID (getpid(3f)) 

getttyent, getttynam, setttyent, endttyent Gets the tty’s file entry (getttyent(3)) 

gettytab Terminal configuration data base (gettytab(5)) 

getuid, getgid Gets the user or group ID of the caller (getuid(3f)) 

getusershell, setusershell, endusersheil Gets legal user shells (getusershell(3» 

hostnm Gets the name of thecurrent host (hostnm(3f)) 

icmp Internet Control Message Protocol (icmp(4p)) 

idate, itime Returns the date or time in numerical form (idate(3f)) 

copysign, drem, finite, logb, scalb copy sign, remainder, (ieee(3m» 

index, rindex, lnblnk, len Tells about character objects (index(3f)) 

ioinit Changes f77 I/O initialization (ioinit(3f>) 

ip Internet Protocol (ip(4p)) 

kill Sends a signal to a process (kill(3f)) 

ldahread Reads the archive header of a member of an archive file 

(ldahread(3x» 

ldclose, ldaclose Closes a common object file (lddose(3x)) 

ldfhread Reads the file header of a common object file (ldfhread(3x)) 

ldlread, ldlinit, ldlitem Manipulates line number entries of a common object file func- 
tion (ldiread(3x)) 

ldlseek, ldnlseek Seeks to line number entries of a section of a common object file 
(Idlseek(3x)) 

ldohseek Seeks to the optional file header of a common object file 

(ldohseek(3x)) 

ldopen, ldaopen Opens a common object file for reading (ldopen(3x)) 

ldrseek, ldnrseek Seeks to relocation entries of a section of a common object file 
(Idrseek(3x)) 

ldsgetamame Retrieves the file name of a member of an archive file 
(ldsgetarname(3x)) 
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ldsgetname Retrieves the section name for a common object file entry entry 
(ldsgetname(3x)> 

ldsgetstring Retrieves a string from the common object file string table 
(ldsgetstring(3x» 

ldshread, ldnshread Reads an indexed/named section header of a common object file 
(ldshread(3x» 

ldsseek, ldnsseek Seeks to an indexed/named section of a common object file 





(ldsseek(3x» 


ldtbindex 


Computes the index of a symbol table entry of a common object file 
(ldtbindex(3x)> 


ldtbread 


Reads an indexed symbol table entry of a common object file 
(ldtbread(3x)) 


ldtbseek 


Seeks to the symbol table of a common object file (ldtbseek(3x)> 


link 


Makes a link to an existing file (link(3f)) 


loc 


Returns the address of an object (Ioc(3f)> 


long, short 


Integer object conversion (tong(3f)) 


ip 


Line printer (lp(4)) 


madvise 


One of Berkeley’s proposed memory management system calls. The 
implementation is based on proposals published by Berkely. (mad- 
vise(3)) 


malloc, free, falloc Memory allocator (malloc(3f» 


map3270 


Database for mapping ASCII keystrokes into IBM 3270 keys 
(map3270(5)) 


mkdir 


The mechanism for assigning the initial file ACL and initial direc- 
tory ACL to the directory created by the mkdir command has been 
changed. The mkdir now works identically to the /com/crd com- 
mand; that is, the initial file ACL and initial directory ACL are now 
inherited from the parent directory. (mkdir(2)) 


mmap, msync, munmap, mremap Berkeley’s proposed memory management system 
calls. The implementation is based on proposals published by 
Berkely. (mmap(3)) 


monitor, monstartup, moncontrol Prepares execution profile (monitor(3)) Multiple pre- 
cision integer arithmetic (mp(3x)) 


mprotect 


One of Berkeley’s proposed memory management system calls. The 
implementation is based on proposals published by Berkely. (mpro- 
tect(3» 


mset, mclear 


Two of Berkeley’s proposed memory management system calls. The 
implementation is based on proposals published by Berkely. 
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(mset(3)) 

dbm_open, dbm_close, dbm_fetch, dbm_store, dbm_delete, dbm_firstkey, 

dbm_nextkey, dbm_error, dbm_clearerr Database subroutines 
(ndbm(3» 

nlist Gets entries from name list (nlist(3)) 

perror, gerror, iermo Gets system error messages (perror(3f)) 

plot: openpl et al. The f77 library interface to plot (3X) (plot(3f)) 

profil Execution time profile (profil(2)) 

putc, fputc Writes a character to a FORTRAN logical unit (putc(3f» 

qsort Quick sort (qsort(3f)) 

rand, drand, irand Returns random values (rand(3f)) 

random, drandm, irandm Better random number generator (random(3f)) 

rename Renames a file (rename(3f)) 

res_mkquery, res_send, res_init, dn_comp, dn_expand Resolver routines (resolver(3» 

( resol ver(5)) 

setoid, seteoid, setroid Organization ID (setoid(3)) 

setreoid Sets real and effective organization ID (setreoid(2)) 

siginterrupt Allows signals to interrupt system calls (siginterrupt(3)) 

signal Changes the action for a signal (signal(3f)) 

sigretum Returns from signal (sigreturn(2)) 

sio Serial I/O (sio(4)) 

sleep Suspends execution for an interval (sleep(3f)) 

cbrt, sqrt Cube root, square root (sqrt(3m)) 

stat, lstat, fstat Gets file status (stat(3f)) 

statfs, fstatfs Gets file system information (statfs(2)) 

stdio Standard buffered input/output package (stdio(3s)) 

symlink This call now supports soft links by using textual links. (svmlink(2)) 

syslog, openlog, closelog, setlogmask Controls system log (syslog(3)) 

system Executes a UNIX command (system(3f)) 

time, ftime Returns system time (time(3c)) 

times The times call now reports 50% of cpu time as user time and 50% 

of cpu time as system time. It previously reported all cpu time as 
user time. (times(3c)) 
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topen, tclose, tread, twrite, trewin, tskipf, tstate f77 tape I/O (topen(3f)) 

Mag tape formats (tp(5)) 

Traps arithmetic errors (traper(3f» 

Traps and repairs floating-point overflow (trapov(3f>) 

Traps and repairs floating-point faults (trpfpe(3f)) 

Finds the name of a terminal port (ttynam(3f)) 

Terminal initialization data (ttys(5)) 

Schedules a signal after a specified time (ualarm(3)) 

Removes a directory entry (unlink(3f)) 

Suspends execution for a time interval (usleep(3)) 

Benson-Varian interface (va(4)) 
vgrind’s language definition database (vgrindefs(5)) 

Virtually “hangs up” the current control terminal (vhangup(2)) 
Waits for a process to terminate (wait(3f)) 

A.2.3 Domain/OS System Calls 

At SR 10, several calls and interfaces have been superseded. 

A.2.3. 1 The name_$ and ios_$ Interfaces 

The name_$name_t and name_$pname_t data types have been superseded to support 
long names. The name_$Iong_name_t supports leaf names up to 255 characters long 
(not including a null terminator), and name_$long_pname_t supports pathnames up to 
1023 characters long (not including a null terminator). In order to use the new longer 
names without breaking existing code, calls that supplied the old short names and did 
not accept buffer length arguments have been superseded by new calls with "_lc" 
suffixes added to their names. The superseded calls are still supported at SR10, but 
may not be available in future releases. The following table summarizes the changes. 



tP 

traper 

trapov 

trpfpe, fpecnt 

ttynam, isatty 

ttys 

ualarm 

unlink 

usleep 

va 

vgrindefs 

vhangup 

wait 
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Interface Changes to Support Long Pathnames 


Superseded Calls 


Replacement Calls 


ios$get dir 


ios $get dir lc 


ios $inq path name 


ios $inq path name lc 


name_$extract_data 


name_$extract_data_lc 


name_$get_ndir 
name _$get ndir cc 


name_$get_ndir_lc 


name_$get_path 
name $get_path cc 


name_$get_path_lc 


name_$get_wdir 
name $get wdir cc 


name_$get_wdir_lc 


name_$read_dir 

name_$read_dir_cc 


name_$read_dir_lc 


name $read link 


name _$read linkjc 



The new default file system object type is unstruct, an unstructured file without a 
streams header, rather than uasc, an unstructured ASCII file with a streams header. 
That means, if ios_$create is called to create an object of type uid_$nil, it will result 
in creating an object of type unstruct. 

The ios facilities can open and access files that do not have type managers, as long as 
the node that is opening the file has the type listed. The ios facilities will then treat 
the file as an unstructured type. 

The ios_$errin and stream_$errin constants are not supported in COFF programs. 
The interface, including the ios_$read and ios_$write calls, is now interruptable. 



A.2.3.2 New prf_$ Calls 

The following new prf calls allow you to program with the new Domain print archi- 
tecture. For more information on the SR 10 Domain print architecture, see Printing in 
the Domain Environment. Printing in the Domain Environment is not available at 
Betal. 



prf_$edit job Edits a print job 

prf_$get_printers Returns a list of printers on the network or by specified print 
manager 

prf_$get_sites Returns a list of print managers 
prf_$read_queue Gets a list of print jobs in the queue 
prf_$signal_ 4 >rinter Signals a printer to stop, suspend, or continue a job 



A.2.3.3 New loader_$ Calls 

The following loader_$ calls are new at SR 10. 
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loader_$load 

loader_$cond_load 

loader_$inlib 

loader__$clear_inlib 

loader_$kg_lookup 

loader_$kg_define 

loader_$lookup_start_addr 

loader_$lookup_stack_size 

loader_$inquire_image 

loader_$inquire_section 

loader_$inquire_stat 

loader_$inquire_known_lib 

A.2.3.4 Changes to gpr_$ Calls 

The gpr_$ calls now support both 7-bit and 8-bit fonts. This support does not change 
the call interfaces and does not require any change in existing programs. 

A.2.3.5 changes to pad_$ Calls 

Two new pad_$ calls are being released at SR 10, pad_$isa, which determines whether 
a stream supports pad operation, and pad_$isa_dm_pad which determines whether the 
stream is open on a loci DM pad. The pad_$isa_dm_pad call is particularly useful 
in determining whether it is appropriate to pop up a pad, in cases where a program 
may be run from a process that is crped onto a remote node and might pop a pad on 
the remote node. 

A new pad_$bw5__ 1 024x800 display type has been added to the pad_$inq_disp_type 
call to support the small monochrome monitor on DN3000 and DN4000 workstations. 

A.2.3.6 Miscellaneous New and Changed Calls and Insert Files 

A new ec2_$wait_slow_io call has been added that behaves like ec_$wait_svc except 
that it recognizes when a signal has been designated to terminate active I/O via the 
BSD sigvec call. This call is provided for compatibility with 4.3BSD. Use it for a 
serial I/O device, for example in a manager, or wherever an indefinite wait can occur 
that should be interruptible by a signal. 

A new osinfo_$get_rev call returns the information contained in the Domain/OS build 
string. This information identifies the date, revision and version of the OS 

The mbx_$start_helper call is released at SR 10. 
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The old 7-bit font format has been removed from the insert files for the smdu inter- 
face. There is a new set of insert and header files for the 8-bit format fonts; these files 
are /sys/ins/fontn.ins.pas /sys/ins/fontn.ins.ftn /usr/include/apollo/fontn.h. 

A.2.3.7 Superseded Interfaces 

As of SR 10, the smd_$ and streams_$ interfaces have been superseded. The ios_$ 
and ios_dir_$ intefaces supersede the streams_$ calls, and the ftmctions provided by 
the smd_$ calls are now better implemented by using pad_$ and graphics calls. 

A.3 Changes to /systest and /sys 

The ts command has been moved from the /systest/ssr_util/ directory to the 
/usr/apollo/bin directory. 

/systest/ssr_util/fmpd is now obsolete. All of its functionality is now reproduced by 
/usr/apollo/tb. 

ctboot has been moved from the /sys directory to the /systest directory. 
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